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This book describes the internal logic of the CVOL Processor and provides 
diagnostic information. This information is directed to maintenance personnel 
and development programmers who require in-depth knowledge of the program’s 
design, organization, and data areas. It is not required for effective use of the 
CVOL Processor. 


You should be familiar with general programming techniques, OS/VS2 concepts 
and use, the general concepts of catalog management, and System/370 before 
reading this book. 


The information in the following manuals, as they apply to the CVOL Processor, 
should be understood before you read this publication: 


OS/VS2 MVS CVOL Processor, GC26-3864, for an introduction to the 
CVOL Processor. 


OS/VSI Catalog Management Logic, SY35-0003, for the internal logic of 
OS/VS catalog management. 


OS/VS2 Catalog Management Logic, SY26-3826, for information on 
Controller II] and VSAM Catalog Management. 


Other publications that this book references and that you may find helpful are: 


OS/VS2 Planning Guide for Release 2, GC28-0667, for information on 
the OS/VS2 system configuration, as well as a list of devices supported. 


OS/VS Message Library: VS2 System Messages, GC38-1002, for VSAM Catalog 
Management return codes. (See the chapter “Access Method Services Messages 
(IDC)” for these messages. ) 


Guide to PL/S I, GC28-6794, for an explanation of PL/S and its listings. 


OS/VS2._ TSO Command Processor Logic Volume IV, SY28-0652-0, for 
information on the VS2 Release | TSO LISTCAT command. 


OS/VS-DOS/VS-VM/370 Assembler Language, GC33-4010, for an explanation 
of Assembler language and its listings. 


OS/VS-VM/370 Assembler Programmer’s Guide, GC33-4021, for an explanation 
of Assembler language and its listings. 


OS/VSI System Data Areas, SY28-0605, which shows the content of most 
of the operating system control blocks and tables for OS/VSI. 


OS/VS2 Data Areas, SYB8-0606, which shows the content of most of the 
operating system control blocks and tables for OS/VS2. 


OS/VS Data Management Services Guide, GC26-3783, for a general 
introduction to Catalog Management, as well as information on generation data 
groups. 

OS/VS2 Access Method Services, GC26-3841, which describes the general 


syntax of the Access Method Services language, the commands of this processor, 
and how they are used. 


OS/VS1 Debugging Guide, GC24-5093, which describes how to analyze a 
main storage dump from OS/VSI1. 
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¢ OS/VS2 System Programming Library: Debugging Handbook, Volume 1, 
GC28-0708, and Volume 2, GC28-0709, which describes how to analyze 
a main storage dump from OS/VS2. 


¢ OS/VS2 System Programming Library: Service Aids, GC28-0674, which > 
describes several service aids and programs available under the VS2 operating 
system. 


e OS/VS2 System Programming Library: Supervisor, GC28-0628, for 
information on the ESTAE macro. 


¢ Data Processing Glossary, GC20-1699, for other data processing definitions 
not found in the glossary of this publication. 


This book is divided into six chapters and a glossary: 


e “Introduction” describes the CVOL Processor and defines the terms used 
throughout the book. 


e ‘Method of Operation” provides the design overview. Emphasis is on the flow 
of data and the concepts of the CVOL Processor, rather than on the 
organization of the CSECTs. 


¢ ‘Program Organization” describes each CSECT of the CVOL Processor and 
identifies the specific function that each CSECT performs to achieve the 
CVOL Processor objectives. This chapter shows the logical flow from CSECT 
to CSECT and contains the flowcharts of the CSECTs. 


e ‘Microfiche Directory” relates information in this book to the listings on 
microfiche. 


¢« ‘Data Areas” describes the work areas that are used by the CVOL Processor. 


¢ ‘Diagnostic Aids’’ shows you how to determine what CSECTs and subroutines 
are used for a particular request. It also shows how to dump and analyze the y 
CVOL Catalog. 


¢ “Glossary” lists terms and acronyms used in this publication. 


In this manual, any references made to an IBM program product are not intended to 
state or imply that only IBM’s program product may be used; any functionally 
equivalent program may be used instead. This manual has references to the following 
IBM program products: 


RACE - Resource Access Control Facility, Program Number 5740-XXH 
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SUMMARY OF AMENDMENTS 
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Data Management (VS2.03.808) 


Release 3 


The CVOL Processor has been enhanced to provide CVOL support that is 
equivalent to VS2 Release 1 and OS/MVT. 


Master Catalog support is unchanged from VS2 Release 3. 


The VSAM master catalog is still the only system master catalog. 


OS Catalog Management in the CVOL Processor has been repackaged in four 
control sections (CSECTS). A fourth CSECT, IGGOCLCF, has been added. 
This addition has changed several program organization figures. 


Staging of data between mass storage and direct-access storage has been 
added for the IBM 3850 Mass Storage System (MSS). Several return codes 
and a program organization figure have been changed for MSS. 
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This book describes the program logic of the OS/VS2 CVOL Processor, 
hereafter called the CVOL Processor. The program is based on the OS Catalog 
Management function, which is included in OS, OS/VS1, or OS/VS2 Release 1. 
The program gets data from and puts data into CVOLs (control volumes), which 


can be created under OS, OS/VS1, or OS/VS2. 


Figure 1-1 shows the flow of control to the CVOL Processor. 


User Request 
OS/VS or VSAM 
SVC 26 


Controller Ill 


CVOL Catalog 
Management 


Interface 


VSAM Catalog 


Management Mappers 


[_ CVOL Processor 


Ce —_— ao —— = oo = — = — — a 


1. When an SVC 26 instruction is issued, Controller II] (IGC0O002F) receives control. SVC 
26 passes a parameter list to Controller III. The parameter list has two possible formats, 
VSAM or OS, depending upon the type of request. 


2. Controller III tests the parameter list. If it is an OS parameter list which specifies a CVOL 
volume serial, Controller III simply passes this request to the CVOL Processor. If it is an 
OS parameter list without a CVOL volume serial, Controller III creates a VSAM parameter 
list and passes the OS parameter list and the newly created VSAM parameter list to VSAM 
Catalog Management. If it isa VSAM parameter list, Controller III simply passes it on to 
VSAM Catalog Management. 


3. VSAM Catalog Management searches the VSAM Catalog for the data set requested in 
the VSAM parameter list. If VSAM finds an alias to a SYSCTLG.x data set in the 
VSAM Master Catalog, it gives control to the CVOL Processor (IGGOCLCA) via an 
XCTL. (Where x is one or more characters that make this name unique from any other 
entry in the VSAM Master Catalog.) Along with control, VSAM passes the parameter 
list(s) from Controller III on to the CVOL Processor. For more information on VSAM 
Catalog Management and Controller III, refer to OS/VS2 Catalog Management Logic. 


4. After the CVOL Processor has processed the SVC request, it gives control directly to the 
program that issued the SVC 26 instruction. 


Figure 1-1. Flow of Control to the CVOL Processor 
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Requirements of the CVOL Processor 


Purpose and Function 


( | The CVOL Processor’s objective is to provide support for CVOLs within the single (VSAM) 
master catalog environment of MVS. The CVOL Processor permits the use of existing 
CVOLs in a multiple CPU environment when running OS, OS/VS1, or 
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Physical Characteristics 


any release of OS/VS2 without converting back and forth between the types of 
catalog structures supported by each operating system. 


If a request is made for a catalog VSAM function against a CVOL Catalog, the 

CVOL Processor maps the request into an OS request and performs the catalog 
function. For more information on how the CVOL Processor operates, see 
Chapter 2 of this publication, “‘Method of Operation.” For a list of requests and 
what the CVOL Processor maps them into, as well as a list of requests that the 
CVOL Processor does not accept, read the ‘‘Introduction’’ of the IBM 
publication OS/VS2 MVS CVOL Processor. 


The CVOL Processor occupies 20,000 bytes of storage and consists of one load 
module named IGGOCLCA. It resides in SYS1.LPALIB and can be paged into real 
storage. The IGGOCLCA load module contains six CSECTs: IGGOCLCA, 
IGGOCLCB, IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF. 


The program organization of the CVOL Processor can be thought of as two 
sections: the Interface Mappers and CVOL Catalog Management. The Interface 
Mappers consist of CSECTs IGGOCLCA and IGGOCLCB. CVOL Catalog 
Mangement consists of CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and 
IGGOCLCF (repackaged OS/VS2 Release 1 Catalog Management). For more 
information on the subroutines and their use within each CSECT, see Chapter 4, 
“Microfiche Directory,”’ of this publication. 


When the CVOL Processor gains control, register 12 points to the work area, 
WORKCLCA, that is passed by VSAM Catalog Management. Controller III 
created WORKCLCA and passed it to VSAM Catalog Management. See Figure 
3-1 and Chapter 5, ‘‘Data Areas,” for a description of WORKCLCA. 


If the request is successful, the data is returned as expected by the original OS or 
VSAM request. Register 15 contains zero. If the request is not successful, the 
CVOL Processor passes a return code in register 15 to the issuer of the SVC 26. 
For a list of return codes and their meanings, refer to the heading ‘‘Processor 
Exit and Output” in Chapter 3 of this publication. For a list of control 
information required and any restrictions on the use of the CVOL Processor, 
refer to the IBM publication OS/VS2 MVS CVOL Processor. 


For examples of which subroutine within the CVOL Processor is involved in any 
given Situation, see Figures 6-1 and 6-2 in this publication. For more information 
on diagnostic aids for the CVOL Processor, see Chapter 6, ‘“‘Diagnostic Aids,” of 
this publication. 


Note: Because all CVOL Catalogs are named ‘SYSCTLG,’ the terms CVOL 
Catalog and SYSCTLG are used interchangeably in this documentation. 
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This chapter contains method of operation diagrams of the main elements of the 
CVOL Processor. A table is included on each diagram which lists each step of 
the diagram, the CSECTs name, and the subroutines used. Using these names, 
you can go either to the chapter “Program Organization” or to the chapter 
“Microfiche Directory” (or the microfiche itself) for more information. 


The following legend explains the symbols used throughout this chapter: 


Data flow 


= Flow of control, entry and exit points 


UZ7Z)> Data flow when existing data has been changed 


On-page connector 


Ose 


Off-page connector 


V 


——_> Pointer to more information 
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Figure 2-1 lists the abbreviations used in the diagrams. 


CVT 


Communication vector table 


An operating system control 
block that provides the address 
of information in the nucleus of 
the non-resident routines. 


DSPE 


entry 


Data set pointer entry 


Generation index pointer 


Contains the simple name of a 
data set and provides the 
location of this data set. 


Points to the lowest index for a 
generation data group. 


ILE 


TCB 


Index link entry 


Index pointer entry 


Supervisor request block 


Links this block to the next 
block in a chain of blocks for 
one index. 


Points to a lower-level index of 
this name. 


An operating system control 
block containing program status 
information and general register 
contents. 


Task control block 


An operating system control 

block that contains information 
and pointers associated with the 
task in progress. 


Figure 2-1. Abbreviations Used in the Diagrams 
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Diagram 1.0 CVOL Processor (Overview) 
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XCTL from IGGOCLA1 or IGCO002F 


PROCESSING 


Allocates CVOL Catalog. 


If OS/VS parameter list, 
determines if request 1s valid. 
Copy user’s parameter list 
into protected storage. 


If VSAM parameter list, 
converts VSAM request to OS 
request and builds OS 
parameter list. If VSAM 
request is a generic locate, 
see Diagram 


Transfers control to CVOL 
Catalog Management, 
see Diagram 
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From Diagram 2.0 
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generation level names. 
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complete 
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Caller’s parameter caller’s area for locate Intermediate results, 
list built by function and GETMAIN for ae 
CAMLST macro non-locate. Also GETMAIN ee Pia teerenen 

| instruction and for IECPBLDL. 
copied into 

protected storage by When locate function 
Interface Mapper. Open the CVOL Catalog. If is requested and data 


Step 3 finds a CVOL pointer, 
call routine IGGOCLIA in 
CSECT IGGOCLCA to 
allocate the new CVOL. Then 


set pointer is found, 
associated block of the 
CVOL Catalog is moved to 
caller's area. 


uoneladGC jo poylwyp 


open the new CVOL catalog A) 
and continue processing. \ 


Use IECPBLDL to search the 
CVOL Catalog for one level 
name. If a pointer to a lower 
index is found, search it for 
the next level of name. 


[ SVRB 


§ Conventional 
type 4 SVC 
information. 


IECPBLDL AREA 
Parameter list 


and input buffer 
for IECPBLDL 


If processing a LOCATE by 
NAME or a LOCATE by TTR 


and control came from 


Diagram 2.1, returns to 
Diagram 2.1 Step 2. 


If processing a relative GDG 
or a LOCATE by NAME, and 
control came from Diagram 
2.0, transfer control to the 
module that issued the SVC 26. 


One block of the 


1 CVOL ey CVOL Catalog is 
Catalog read each time 

- \ IECPBLDL is 
called. 


Step CSECT Subroutine 


IGGOCLCO 
IGGOCLCO 


IGGOCLCC 
2 IGGOCLCC 
4 IGGOCLCC IGGOCLC2 


4 


If processing a non-locate 
function (CATBX, UCATDX, 

or RECATLG), 2) 
see Diagram 


Diagram 3.0 CVOL Catalog Management (Gets Information) 
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INPUT 

Simple name ol 

data set to be 

added or deleted 

from the CVOL Catalog. 


Additional 
mformation for 
new CVOL Catalog 
entry volume 
identifications, 
alias name. 

track address. 

ete. as required 


by type of entry. 


Index block to which change is to 


be made. 


From Diagram 3.0 or 3.2 


PROCESSING 


Point to entry to delete or 
construct new CVOL Catalog 
enury. 


Copy index block to output 


buffer, one entry at a time. 
Merge new entrv into 
collating sequence (ADD 
function), or skip over named 
entry (DELETE function). 
Displacement of following 
entries can result in an update 
to the next index block. 


If processing a CATBX, 
transfer control to the module 
that issued the SVC 26. 


If processing a UCATBX or 
RECATLG, see Diagram 


Diagram 3.1 CVOL Catalog Management (Sets Up) 


u 


All catalog entries have the same 
format. Name field determines 


entry’s position in the block. 


a” 


Output for 
DELETE. 
Entry 

M has been 
deleted. 


Step | CSECT | Subroutine 


| | 1GGOCLCD 
- | IGGOCLCD | IGGOCLC4 _ 
3 | 1GGecLcD _| 1GGocLes 


OUTPUT 


Updated index 
block built into 
the output 

bulfer. 


Unused 


IGGOCLC3 


IGGOCLCD IGGOCLCS 


uonelsdg Jo poyyep 
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INPUT 


Updated 
index 
blocks 


Address (TTR) 
of block of the 
CVOL Catalog 
to which this 
updated block is 


to be written. 


C eS C 


From Diagram 3.1 


PROCESSING OUTPUT 


1. Rewrite block of the CVOL 
Catalog. Changes to this 
block may ripple to following 
blocks of index chain; that 1s, 
a change to following blocks 
might now be set up. 


If so, see Diagram =") 


Updated 
CVOL 
Catalog 


Register 15 


2. Transfers control to the ee [ 


module that issued the SVC 26. 


[Step CSECT 
pb iacocice | 1GGecLcs 


IGGOCLCE IGGOCLC7 


Diagram 3.2 CVOL Catalog Management (Writes) 
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The CVOL Processor consists of one load module named IGGOCLCA that 
resides in SYS1.LPALIB. IGGOCLCA contains six CSECTs: IGGOCLCA, 
IGGOCLCB, IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF. The 
program organization of the CVOL Processor can be thought of as two 
sections: the Interface Mappers and CVOL Catalog Management. The 
Interface Mappers consist of CSECTs IGGOCLCA and IGGOCLCB. CVOL 
Catalog Management consists of CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, 
and IGGOCLCF (repackaged OS/VS2 Release 1 Catalog Management 
functions). See Figure 1-1 in this publication for an overview of the flow 

of control to the CVOL Processor. 


Input 


The CVOL Processor, module IGGOCLCA, gains control via an XCTL from 
Controller III, module IGC0002F, when an OS/VS style catalog request is 
issued which specifies a CVOL volume serial in the parameter list. 


The CVOL Processor, module IGGOCLCA, also gains control via an XCTL from 

VSAM Catalog Management, module IGGOCLA1, when VSAM finds an alias to 
a SYSCTLG.x data set in the VSAM Master Catalog. (Where x is one or more 
characters that make this name unique from any other entry in the VSAM 


Master Catalog.) This alias entry indicates that the data set requested by SVC 26 
resides on a CVOL Catalog. 


Standard linkage is not used with the CVOL Processor. Register 1 points to a 
parameter list that is not needed by the CVOL Processor. Register 12 points 

to the work area named WORKCLCA that was created by Controller III. When 

the CVOL Processor gets control, it ignores the contents of register 13. The 

CVOL Processor puts the address of its own save area in register 13 and saves 

registers in that save area. Register 15 contains the entry point address of IGGOCLCA. 


Register 14 is not used. Figure 3-1 illustrates the key fields within WORKCLCA that 
the CVOL Processor depends upon. 
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Register [2 


WORKCLCA 
Catalog Alias 
CVOL volser = 0 


Original VSAM 
parm list 


| OS Request without a CVOL volser 


Register [2 


WORKCLCA 


. vo J e » 
Catalog Alias 
CVOL volser = 0 


CTGPLPTR 
CAMPLPTR 


VSAM version 
of OS parm list 


a a: 7 


OS Request with a CVOL volser 


Register 12 


Original OS 
parm list 
(no CVOL 
volser) 


CVOL volser fed 
CTGPLPTR = 0 


CAMPLPTR 


ere 


If the parameter list passed to SVC 26 indicates a VSAM request, CTGPLPTR and 
CAMPLPTR point to the VSAM parameter list. 


If the parameter list passed to SVC 26 indicates an OS request, CAMPLPTR points 
to the OS parameter list. 


If the OS parameter list specifies a CVOL volser, then CTGPLPTR is zero, the 

CVOL volume serial field has been filled in by Controller III, and the catalog name 
and alias fields remain uninitialized. If the OS parameter list specifies no CVOL 
volser, then CTGPLPTR points to the VSAM parameter list created by Controller III, 
the CVOL volume serial field is set to binary zeros, and the catalog name and alias 
fields have been filled in by VSAM Catalog Management. 


Original OS 
parm list 

(including CVOL 
volser) 


Figure 3-1. WORKCLCA at Processor Invocation 
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Processor Exit and Outout 
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CVOL Processor gives control to the issuer of the SVC 26. If no errors were 
encountered, register 15 contains zero. If an error has occurred, register 15 
contains a return code indicating the type of error. When the contents are 
significant, the meaning is noted below. In some cases registers 0 and 1 
provide further information concerning the error. The meaning of the return 
code varies according to the type of catalog request. Refer to the following 
lists for return code meanings. 


If the request is a VSAM request, register 15 contains a return code defined 
by VSAM Catalog Management. These return codes are explained in OS/VS 
Message Library: VS2 System Messages, in the chapter called “Access Method 
Services Messages (IDC).” If the request is an OS request, register 15 contains 

one of the return codes described in the following lists. Register 0 contains the 
VSAM Catalog Management return code if the OS request was satisfied in a 
VSAM Catalog and if register 15 does not contain a 0. Refer to the following 
lists for return code meanings. 


OS LOCATE Macro Return Codes 


| OS INDEX Macro Return Codes 


If processing an OS locate request, register 15 may contain: 
e O—Successful. 


e 4—Either the required CVOL Catalog does not exist, could not be 
allocated, or an MSS (Mass Storage System) acquire failed. 


e 8—One of the following: 
1. Entry not found. RO contains number of index levels. 
2. Protection violation. RO=56. 
3. GDG alias found. RO contains number of index levels. 


e 12—Non-data set found at last qualifier. RO contains number of index 
levels. 


e 16—Data set exists at an earlier level of qualification. RO contains number 
of index levels where data set was encountered. 


e 20—Syntax error in data set name. 
e 24—One of the following: 
1. Permanent I/O error. RO=VSAM return code or 0 if error in CVOL. 
2. Unrecoverable error (including ‘Do not allocate’). RO=0 
3. Non-zero ESTAE return code. RO=O. 
4. Error in CAMLST. RO=0. 
e 28—TTR is out of range. 


When processing an OS BLDX, DLTX, LNKX, BLDG, BLDA, DLTA, or 
DRPX request, register 15 may contain: 


« O—Successful. 
e 4—CVOL not available. 
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e 8—Catalog structure inconsistent with specified operation. RO same as RO 
on a LOCATE on this name. R1 same as R15 on a LOCATE on this 
name. 


e 12—Can’t delete a non-empty index. 
Cc e 16—Necessary index structure does not exist. 
e 20—Space unavailable in catalog. 
e 28—One of the following: 
1. Permanent I/O error. 


2. Non-zero ESTAE return code. 
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OS CATALOG, UNCATALOG, or RECATALOG Return Codes 


When processing an OS CATALOG, UNCATALOG, or RECATLOG request, 
register 15 may contain: 


@e 0-Successful. 


| © 4—Either the required CVOL Catalog does not exist, or the CVOL Catalog cannot 
be allocated or acquired. 


@ 8—One of the following: 


1. Catalog structure inconsistent with the operation requested (including alias for 
GDG found). RO same as RO on a LOCATE on this name. R1 same as R15 on 
a LOCATE on this name. 

2. Protection violation. RO=56. R1=0. 


e 20-Insufficient space on a CVOL Catalog data set. Register 0 contains zero. 
@ 24-Improperly named generation data group not cataloged. 
@ 28—-One of the following: 


1. A permanent I/O error or an unrecoverable error occurred. 
2. An error was found in‘the OS parameter list. 

3. An I/O error occurred in a CVOL Catalog. 

4. An ESTAE return code was non-zero. 


VSAM SUPERLOCATE Return Codes When Accessing CVOL Catalogs 
When processing a VSAM SUPERLOCATE request, register 15 may contain: 


@ 0-Successful. 
@ 4—Allocation error occurred or unable to open a CVOL Catalog. 
@ 8—Data set not found or the structure of the CVOL Catalog was inconsistent. 
@ 24—1/O error or unrecoverable error. 
| e 44-Insufficient space available to CVOL Processor. 
@ 68-The CVOL Catalog cannot be allocated. 


@ 164—ESTAE return code was non-zero. 
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Other VSAM Request Return Codes When Accessing CVOL Catalogs 


When processing VSAM requests other than SUPERLOCATE, register 15 may 
contain: 


e O—Successful. 

e 4—Allocation error or unable to open a CVOL Catalog. 

e 8—Data set not found or the structure of the CVOL Catalog was inconsistent. 
e 24-1/O error or unrecoverable error trying to locate information. 


e 28-I/O error or unrecoverable error on any request action except trying to 
locate information. 


e 40-Insufficient space. 
e 48-Invalid function, not consistent with a CVOL Catalog. 


e 164—ESTAE return code was non-zero. 
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Overall Program Organization of the CVOL Processor. 


Figure 3-2 gives the overall program organization of the CVOL Processor. The 
figure is followed by a description of each of the CSECTs that the CVOL 
Processor contains. 


IGGOCLCA 


Determines type of request 


IGGOCLCB 


Processes VSAM 
generic locate 
request 


IGGOCLCC 


Reads CVOL 
Catalog Entry 


IGGOCLCD 


Sets up CVOL 
catalog operation 


IGGOCLCE 


Processes CVOL 
catalog operation 


Gives control directly to the 
Return program that issued the SVC 26 
instruction. 


Figure 3-2. Overall Program Organization of the CVOL Processor ) 
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Interface Mappers 


CSECTs IGGOCLCA and IGGOCLCB are called the First and Second Interface 
Mappers because they map VSAM requests into OS requests. 


c CSECT IGGOCLCA 


CSECT IGGOCLCA, First Interface Mapper, is the entry and exit point for the 
CVOL Processor. After ensuring that the PCCB (Private Catalog Control Block) 
is valid, IGGOCLCA determines what type of request has been sent to the 
CVOL Processor and calls the appropriate subroutine. Figure 3-3 lists the types 
of requests IGGOCLCA honors, the subroutine that receives control, the action 
performed, and any other CSECTs called. 


Other CSECTs 
Type of Request Subroutine Action Performed Called 


OS CAMLST OSREQ Sets up and executes an IGGOCLCC 
format original OS CAMLST format 
request. 


SUPERLOCATE Determines type of IGGOCLCC 
superlocate and calls the 

appropriate procedure: 

SLGDG, base generation 

number supplied; SLGDGB, 

locate GDG base only 

supplied; or SLNAME, normal 

superlocate. 


VSAM locate VLOC Processes a VSAM locate. IGGOCLCC 


VSAM delete DELETE Processes a VSAM delete IGGOCLCC 
request by issuing an OS 
UCATDX request and 

optionally a SCRATCH. 


Processes a VSAM generic 
locate. 


SUPERLOCATE 
without generic 
locate 

specified 


SUPERLOCATE 
with generic locate 
pecified 
Access Method 
Services LISTCAT 

without GET NEXT 
option 


Figure 3-3. Requests to IGGOCLCA 


GENLOC IGGOCLCB 


Processes an Access Method |IGGOCLCC 
Services LISTCAT (not GET 


NEXT) request 


All other VSAM requests not listed in Figure 3-3 are rejected with a return code 
of 48 in register 15, and control is returned to the issuer of the SVC 26 
instruction. CSECT IGGOCLCA is written in PL/S-2, a high-level, proprietary 
system language. Listings produced for microfiche consist of the PL/S-2 source 
code, a cross-reference and attribute table, and the assembly code. See the IBM 
publication Guide to PL/S — Generated Listings, for a more detailed 
explanation of PL/S and its listings. 


Note: Guide to PL/S — Generated Listings describes PL/S-1, but IGGOCLCA 
uses PL/S-2. If you can read PL/S-1, you can read PL/S-2. 
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CSECT IGGOCLCB 


CSECT IGGOCLCB, Second Interface Mapper, is a modification of TSO 
LISTCAT from VS2 Release 1. All TSO options have been removed for 
IGGOCLCB leaving the basic function of LISTCAT. The basic function 
produces a list of data set names found cataloged under the requested high-level 
qualifiers. Listings produced for microfiche consist of the Assembler source code, 
a cross-reference and attribute table, and the assembly code. For more 
information on Assembler language, see the IBM publications OS Assembler 
Language and OS Assembler (F) Programmer’s Guide. 


Figure 3-4 shows how the Segment (CIRBLOCK) entries are processed after the 
first segment block information is returned by CIR. This example assumes the 
‘01’ and ‘02’ option codes (data set names and index names) have been 
requested, and that the USERID is used as a node point for the catalog search. 


The catalog structure for this example is: 


USERID 
SETI SET2 
er eee 
LEVEL! C D E 
— 


A  B 


where SET1, SET2, and LEVEL1 are index names and A-E represent the lowest 
level, fully qualified, data set names. 
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1. Four segment blocks are initialized. 
CURNTBLK and FRSTBLK are made to point UN ERS Tet 
to the first segment block. The current entry Paes lige | 
pointer is zeroed. IGGOCLCB then uses | C ‘ 
routine OBTBLK to find the first segment eee a ese any 

( block containing a zeroed current entry field. blandit hl 


OO 
a) a cr ; STE 


SS 
e -|. k 


2. Then IGGOCLCB calls CIR, which reads the 


first index block and formats the entries. CURNTBLK FRSTBLK 


3. Control returns to IGGOCLCB, which then gets 
the CURNTBLK value, establishes a pointer 
to, and makes the current-entry field reflect the 
first entry (see MAINOO). 


CURNTBLK FRSTBLK 


MAINO1) and finds it to be an index name. CURNTBLK FRSTBLK 
Control is then passed to routine INDEXRT, 
which sets up a parameter list for CIR and uses 
subroutine OBTBLK to get a new block for the 
next lower level of qualifiers. (OBTBLK 
checks the chain, sees that the current-entry 
pointer is not zeroed, gets the address of the 
next block in the chain and puts it in 
CURNTBLK.) 


( 4. IGGOCLCB analyzes the list entry (see label 


5. OBTBLK returns control to INDEXRT, which 
calls CIR and reads the next block from the 
catalog. The current-entry pointer of the 
second block is updated to point at the first 
entry in that block. A check is then made to 


. . » . . oN 

see if the entry is a link entry (in this case, no). PO SETI SET2. Link Entry (zero TTR) 
co” 

a a TST 


CURNTBLK FRSTBLK 


6. Control returns to IGGOCLCB at MAINO1, 
“ which continues processing as in step 4. CURNTBLK FRSTBLK 


co 
| SETI SET2 /*Link Entry (zero TTR) 


oO 
AT EVEL OC Link Entry (zero TTR) 
I ee 


c 


Figure 3-4. IGGOCLCB Example of Catalog Segment Block Handling (1 of 2) 
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11. 


12. 


Figure 3-4. 
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Control passes from INDEXRT to CIR, which 
reads in the block upon return to INDEXRT, 
the current-entry pointer is updated to point at 
the first entry of the third block. A check is 
made for a link entry in this position (in this 
case, no). 


Control is returned to IGGOCLCB, through 
label MAINO1, which tests for entry type and 
finds the data set name .SET1.LEVEL1.A. 


After the current entry is processed, control is 
returned to the POINTER subroutine, which 
updates the current-entry pointer of the third 
segment block to point to the B entry. A check 
is —— to see if it is a link-entry (in this case, 
no). 


Processing for .SET1.LEVEL1.B continues (as 
in steps 8 and 9). This time, when the 
current-entry pointer is updated, the POINTER 
subroutine finds a zeroed link-entry. The 
current-entry pointer of the third segment 
block is cleared, releasing the block for 
possible future use. CURNTLBK is updated to 
point to the second block. 


Control is returned to IGGOCLCB, through 
MAINO1, which updates the current-entry 
pointer of the current block to point to the 
next entry. The next entry is a data set name 
entry and is processed. 


The remainder of the operation is summarized 
as follows: 


¢ When the zero-TTR in the second segment 
block is encountered, the block is released, 
and the CURNTBLK is updated to point to 
the first block. 


¢ The current-entry pointer is updated to 
point to SET2. SET2 is an index name, 
which means that CIR is entered to read 
into segment block 2. The new second-level 
information (D, E, and a zero-TTR link 
entry) overlays the old. 


e When no more entries remain to be 
processed (that is, when a zero-TTR link 
entry is encountered in the first segment 
block), the POINTER routine passes control 
to WRAPUP in IGGOCLCB, which cleans 
up and returns control to IGGOCLCA. 
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CURNTBLK FRSTBLK 


ce 
LT SET SETZ__/Link Entry (zero TTR) 


CO 

pT tevett Link Entry (zero TTR) 
oo 

po AB Link Entry (zero TR) 


Link Entry 


CURNTBLK FRSTBLK 


fv ™ 
Ss A a 
f™ 
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CURNTBLK FRSTBLK 


fc ™ 
Sa 


ee Sa a 
eo 
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Character Dependency for CSECTs IGGOCLCA and IGGOCLCB 


System Macros Used by 


The CSECTs IGGOCLCA and IGGOCLCB require that the character set used at 
execution time be equivalent to that used at assembly time. The IBM-supplied 
version of the interface mappers assumes EBCDIC character representations. If a 
different character set is to be used during execution, the CSECTs must be 
re-assembled. 


CSECTs IGGOCLCA and IGGOCLCB 


Figure 3-5 lists all system macros used by CSECTs IGGOCLCA and 
IGGOCLCB and the label closest to each point of issue. 


DEQ | IGGOCLCA_|SRCHPCCB 
IGGOCLCA SRCHPCCB 
IGGOCLCA |IGGOCLIA 


iccocLca |!GGOCLCA 
<== iF 


ESTAEXIT 
||GGOCLCB 


ENQ 


ESTAE 
ESTAEDK 


WRAPUP 


IGGOCLCA | IGGOCLCA 


FREEMAIN WRAPUPO2 


FREEMMDL 
FREEML 


1IGGOCLCB 
OUTBLKO2 
IGGOCLCB GETMLMDL 


GETML 
IGGOCLCA |IGGOCLCA_ 


GETUSERK 
GETSVCK 


BUILDNAM 


IGGOCLCB 


GETMAIN | 


LINK 


IGGOCLCA 


MODESET 


IGGOCLCB 


RETURN 


IGGOCLCB 


SAVE 


SCRATCH 


_OUTBLKO7 


ERREXIT 


_|.NORMEXIT 


IGGOCLCB 


IGGOCLCB 


_|CIR 


IGGOCLCA 


DELETE 


Figure 3-5. System Macros Used by CSECTs IGGOCLCA and IGGOCLCB 


Resource Enqueuing for CSECTs IGGOCLCA and IGGOCLCB 


During catalog allocation, CSECT IGGOCLCA enqueues on a chain of Private 
Catalog Control Blocks (PCCBs). The major name for enqueuing is always 
SYSZPCCB, and the minor name for enqueuing is always PCCB. CSECT 
IGGOCLCB does not use resource enqueuing. 


During catalog allocation, IGGOCLCA also issues two ENQs to preserve data 
integrity. For both ENQs the minor name is SYSCTLG.Vxxxxxx, where xxxXxxx is 
the volume serial of the CVOL. The major names used are (1) SYSZOPEN and 

(2) SYSDSN. 


The SYSDSN ENQ prevents the CVOL from being scratched during SVC 26 
processing. The SYSZOPEN ENQ is issued to prevent an unallocation that 
could dequeue the SYSDSN ENQ. 
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Register Usage for the Interface Mappers 


Both Interface Mappers use registers in an identical manner, except as noted. 
Registers 


10 Second base register for CSECT-IGGOCLCA only 
11 Base register for CSECT 


12 Base register for WORKCLCA 
structure 
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Repackaged Catalog Management 


OS Catalog Management in the CVOL Processor has been repackaged into four 
CSECTs: IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCEF. The first 
three CSECTs contain the three OS Catalog Management phases referred to in 
OS/VS1 Catalog Mangement Logic. The three OS/VS phases contain eleven 
separate modules, while the four CVOL Processor CSECTs contain eleven 
subroutines. Figure 3-6 gives a comparison of the four CVOL Processor CSECTs 
versus the three OS Catalog Mangement phases. 


Old Phase 


Phase | 


Phase II 


———__+ 


Phase III 


Figure 3-6. 


in the CVOL Catalog. 


Modules 
Contained 


IGGOCLCO 
IGGOCLC1 
IGGOCLC2 


IGGOCLC3 
IGGOCLC4 


IGGOCLCC 


Subroutines 
New CSECT Contained Changes Made 


IGGOCLCO 
IGGOCLC1 
IGGOCLC2 

IECPBLDL 


oe 


IGGOCLCI1 and IGGOCLC2 
return to IGGOCLCA or 
IGGOCLCB, whichever called 
IGGOCLCC., IECPBLDL was 
previously a separate service 
routine and is now included in 
IGGOCLCC. 


IGGOCLCD 


IGGOCLC5 
IGGOCLC6 
IGGOCLC7 


1GC0002H 
IGGOCLF2 


IGGOCLCE 


IGGOCLCF 


—_— 


IGGOCLC3 
IGGOCLC4 
IGGOCLCS 


|1GC0002H 


IGGOCLF2 


‘IGGOCLC7 returns to 
\IGGOCLCA or IGGOCLCB, 


IGGOCLC6 
IGGOCLC7 


'IGG0553A for new extents. 


IGGOCLC5 was previously 
included in Phase III. 


whichever called IGGOCLCC. 


IGC0002H and IGGOCLF2 were 
not previously considered part of 
Phase III but as auxiliary service 


routines. IGCO002H calls 


IGC0002H returns to caller, as 
does IGGOCLF2. IGGOCLF2 ts 
now only the SYSCTLG 
Formatter: it no longer performs 
BPAM directory format. 


OS Catalog Management Compared to the New CVOL Catalog 
Management 


Program Organization of CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 


CSECT IGGOCLCC, the entry point for CVOL Catalog Management, is called 
from CSECT IGGOCLCA or CSECT IGGOCLCB. IGGOCLCC passes control 
to CSECTs IGGOCLCD and IGGOCLCE via branch instructions. IGCO002H, 
one of the service subroutines, is invoked via a branch instruction; it passes 
control to IGGOCLF2 via a branch instruction. The path that occurs through the 
remaining subroutines of the three CVOL Catalog Management CSECTs 
depends on both the particular function requested and the entries that are found 


All of the CVOL Catalog Management CSECTs are re-entrant. They use a 
common work space, WORKAREA, that is initialized by IGGOCLCO. (See 
Chapter 5, ‘‘Data Areas,” for a description of WORKAREA.) 


Each block in Figure 3-7 represents a subroutine of the CVOL Catalog 
Management routines and contains a brief description of the functions it 
performs. Each path is identified by the function/condition it represents. 


Figure 3-7 gives the overall program organization of CSECTs IGGOCLCC, 
IGGOCLCD, IGGOCLCE, and IGGOCLCF. 
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Enter 


IGGOCLCC 
Called by 
IGGOCLC1 or IGGOCLC2 


IGGOCLCO—Initialization 


Alias or 


B ae . k 5. 
Initialize work areas BLDA. LNKX 


¢« Open given CVOL. 
¢ Search for high level name. 


All modules go to 
IGGOCLC7 on error 
conditions (paths 
not shown here). 


IGGOCLC1I—Relative GDG and Alias IECPBLDL 


e Resolve alias. 
e Construct BLDA or LNKX entry. 
« Process relative GDG. 


Search for qualified name in 
catalog. 


Relative GDG 


IGGOCLC2—Locate 


Return to 
Catalog 
Management 


Non-locate 
Functions 


¢ Search lower levels of name 
« Save last valid level of index . 
« Relocate CC Ws. 


Return to 
IGGOCLCA or 
IGGOCLCB 


Locate functions 


Return to 
IGGOCLCA or 
IGGOCLCB | 


IGGOCLCD IGGOCLC3—Update Initialization 


and Entry Building 


e Ensure that VICE. ICE. and 
space present. 

e Construct and write new index 
block. 


« Route non-locate request. 


UCATDX with blocks to free 
CATBX, CAT. 
RECATLG 


VCBs to be written or 
VCB or Index blocks 
to he freed. 


IGGOCLC4—Fntry Building 


« Construct new DSPE or VCBPE. 
¢ Scratch GDG if needed. 


IGGOCLCS—First Load of Update 


« Set "Must Complete on. 
e Free VCBs or index blocks. 
e Write VCBs. 


“T Perform EMPTY option as needed 
IGGOCLCF IGGOCLCE — ? 


[GC0002H—Open/ Extend IGGOCLC6—Second Load of 
« Build DCB/DEB. Update 
« XCTL to IGGO0553A for 


new extent. ¢« Add or delete entry from index 
« Call IGGOCLF2 to format block. 
new SYSCTLG. ¢ Ripple as needed. 


« Acquire DASD space for 
SYSCTLG data sets residing 


on virtual volumes. IGGOCLC7—Third Load of Update 


and Error Handling 


Write last index block. 
Update ICE and VICE. 

Write environment record for 
error condition. 
Set return code. 


IGGOCLF2—SYSCTLG Formatter 


¢ Format extent. 
Return to 


e Initialize VICE block. 
Return to Caller 
IGGOCLCA or 
IGGOCLCB 
Return to Caller 


¢ Figure 3-7. Overall Program Organization of CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF. 
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CSECT IGGOCLCC 


CSECT IGGOCLCD 


CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF use Assember 
language. Listings produced for microfiche consist of the Assembler source code, a 
cross-reference and attribute table, and the assembly code. For more information 
on Assembler language, see the IBM publications OS/VS-DOS/VS-VM/370 Assembler 
Language and OS/VS-VM/370 Assembler Programmer’s Guide. 


CSECT IGGOCLCC performs the read operation. IGGOCLCC performs locate 
functions and the locate part of non-locate functions. A locate function is a 
LOCATE by NAME or LOCATE by TTR, that is. a read-only function. A 


non-locate function is CATBX,UCATDX, BLDA, BLDG, BLDX, DLTA, DLTX, 
LNKX, DRPX, or RECATLG, that is, an update function. 


© IGGOCLCO (Initialization) initializes work areas and opens the CVOL 
Catalog. 


e IGGOCLC! (Relative GDG and Alias) resolves aliases and relative GDG 
numbers. 


e MsGOCLC2 (Locate) searches the lower levels of the index structure. 


e IFECPBLDL (Search) searches for the qualified name in the CVOL Catalog. 


CSECT IGGOCLCD performs the setup operation for adding or deleting entries 
in the CVOL Catalog. (GGOCLCD checks the validity of the requests against 

the existing entries in the CVOL. Catalog and builds new entries to be added or 
names entries to be deleted. [TGGOCLCD consists of the following subroutines: 


© IGGOCLC3 (Update Initialization and Entry Building) begins the update 
process by building new index blocks and routing the request as needed. 


© IGGOCLC4 (Entry Building) builds data set pointer entries to add to the last 
valid level of the index. 


© IGGOCLCS (First Load of Update) frees index blocks, frees volume control 
blocks (VCBs), and writes new VCBs. 
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CSECT IGGOCLCF 
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CSECT IGGOCLCE performs the write operation. It merges entries into CVOL 
Catalog blocks, deletes entries from the blocks, and does most of the writing that 
is needed. IGGOCLCE consists of the following subroutines: 


¢ IGGOCLC6 (Second Load of Update) updates blocks, writes updated blocks 
to the CVOL Catalog, and ripples the changes as needed to the last block of 
the updated chain. 


© IGGOCLC7 (Third Load of Update and Error Handling) writes the last 
updated block, updates the control entries, returns control to IGGOCLCA or 
IGGOCLCB (whichever called IGGOCLCC), and handles error conditions. 


Note: Subroutines IGGOCLCS, IGGOCLC6, and IGGOCLC7 are entitled First, 
Second, and Third Loads respectivély. These subroutines are not load modules, 
and the use of ‘‘Load” in their titles is a part of their name in the CVOL 
Processor. 


The two service subroutines included in IGGOCLCE are: 


¢ 1GCO002H (SYSCTLG Open/Extend) opens the CVOL Catalog data set 
or gets the next extent of that data set when needed. 


e IGGOCLF2 (SYSCTLG Formatter) formats a new CVOL Catalog. 


For example, follow the path for a CATBX function (request to add a data set 
name to the CVOL Catalog and create any missing index levels) on a CVOL 
Catalog. Assume that part of the index structure already exists; that is, this 
request extends an existing index structure before adding the data set name to 
the catalog. Refer to Figure 3-7 to coordinate the labels mentioned in the 
example. 


Specifically, this is what each subroutine does to accomplish the CATBX request: 


e Entry to CVOL Catalog Management is at IGGOCLCC. IGGOCLCC routes 
the request to IGGOCLCO. 


¢ [GGOCLCO initializes work areas, opens the CVOL Catalog, and locates the 
high-level name of the index structure. The arrow labeled “Other” is the exit 
path for this example. 


e IGGOCLC2 locates the remaining levels of the existing index structure to find 
the last valid level. The new index is added to that level. 


e CATBX is a non-locate function, so control passes to IGGOCLC3. This 
subroutine reads the control entries, index control entry (ICE) and volume 
index control entry (VICE), and routes the request (via the arrow labeled 
“CATBX, CAT, RECAT”). IGGOCLC4 constructs the DSPE. Control 
returns to IGGOCLC3 (via the arrow labeled ‘CATBX’), where the required 
index levels are built and written into the CVOL Catalog. When an existing 
level is reached, control passes to IGGOCLC6. 
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¢ IGGOCLC6 inserts the new IPE into the index block left by IGGOCLC2. 
IGGOCLC6 writes the updated block to the CVOL Catalog, and ripples the 
effect of the change down the index chain, if necessary. The last block of the 
chain is left in the input/output buffers, but it is not written to the CVOL 
Catalog. 


e IGGOCLC7 writes the last block of the updated index chain, then reads, 
updates, and rewrites blocks containing the ICE and VICE. Resources are 
released and control passes back to the caller of IGGOCLCA or IGGOCLCB. 


Traces, such as the one just described, are illustrated in the chapter *‘Diagnostic 
Aids” as an aid in identifying the CSECTs involved in any particular situation. 


Services Used by CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 


Two services are used throughout the CVOL Catalog Management subroutines. 
The prologue commentary for each CSECT lists the specific services used in that 
CSECT; the services are: 


e IECPCNVT is a routine used to convert relative track addresses to absolute 
addresses. It 1s accessed through entry point IECPCNVT whose address is 
found in field CVPPCNVT of the Communication Vector Table (CVT). In 
the CVOL Catalog Management routines, this routine is used in the closed 
subroutine labeled ““TOABSL”. 


« IECPRLTV is a routine used to convert absolute track addresses to relative 
addresses. It 1s accessed through entry point IECPRLTV, whose address is 
found in field CVTPRLTV of the CVT. In the CVOL Catalog Management 
routines, this routine is used in a closed subroutine labeled ‘““‘TORLTV”™, 


Character Dependency for CSECTs IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 
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The CSECTs of CVOL Catalog Management require that the character set used 
at execution time be equivalent to that used at assembly time. The IBM-supplied 
version of CVOL Catalog Management assumes EBCDIC character 
representations. If a different character set is to be used during execution, the 
CSECTs must be re-assembled. The instructions involved in this dependency are 
identified by label in the prologue commentary of each CSECT. 
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System Macros Used by CSECTs IGGOCLCC, IGGOCLCD, 
IGGOCLCE, and IGGOCLCF 


Figure 3-8 lists all of the executable system macros used by CSECTs IGGOCLCC, 
IGGOCLCD, IGGOCLCE, and IGGOCLCF and the label closest to each point of 


issue. 


Macro 
IGGOCLCC ,DEQUE 
DEQVI 
ERROO 
‘EXCLUSIV 


‘FREERES 


ENQVI 
|IGGOCLCS 


IESTAESET 
IGGOCLCA 


IGGOCLCE |FREWA2 
IGGOCLCC BI 


IGGOCLCC 


ESTAE 


EXCP EXCPI 


IGGOCLCE Excp?2 

iccocicr |!93 
eer 1O 

IGGOCLCC |DEQVI 


IGGOCLCD _FRVCBEND 


SKIPS 


RPSTST 
FREEMAIN FREEWA2 


IGGOCLCE ap 
‘RETURN 


— ss | CONTINUE 
IGGOCLCF |RNVIRT4 


RBT 
_ | CONTINUE 


‘(OPENGTMN 
Le IRELOC 
ENQVI 
GETMAIN | IGGOCLCD |SCRATCH 
ae |FRVCBTN 
- I1GGOCLCE \prTTRP 
GETMAINB 
NOFMT 
oe FORMAT 
IGGOCLCF |RTTCTA 
IGGOCLCF jEXTENDC 
EXTENDAA 


IGGOCLCF 


‘ICBACREL 
MODESET 


RACHECK 


IGGOCLCC_| 
IGGOCLCC 


| IGGOCLCD |EXCP3 


EXCPI 
EXCP2 


IGGOCLCE 


IGGOCLCF 44 
IGGOCLCF |RVIRT8 
IGGOCLCE |RXP4 


IGGOCLCF _|EXTENDAA 


Figure 3-8. System Macros Used by CSECTs IGGOCLCC, IGGOCLCD, 


IGGOCLCE, and IGGOCLCF 
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Resource Enqueuing for CSECTs IGGOCLCC, IGGOCLCD, 
IGGOCLCE, and IGGOCLCF 


Three resources are used: high-level name, volume index, and volume index 

control entry (VICE). To prevent an interlock between two callers, the 

high-level name is a/ways enqueued first, the volume index is enqueued second, 

and the VICE is enqueued last. a 


The conditions of enqueuing are determined from the request. If the volume 
index is to be modified, then the volume index must be enqueued exclusively. 
Otherwise, it can be shared. If a locate function is requested, then the high-level 
name can be shared. If a non-locate function is requested, the high-level name is 
enqueued exclusively to protect all lower-level indexes under it. 


The major name for enqueuing is always ‘SYSCTLG’. The minor name is the 
high-level name with the UCB (unit control block) address appended to it, 
‘SYSCTLG’ with the UCB address appended to it, or zeros with the UCB 
address appended to it. 


Register Usage for CVOL Catalog Management 
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With the exception of IGCO002H and IGGOCLF2, the CVOL Catalog 
Management CSECTs use a common set of registers. Subroutine IGGOCLCO 
initializes these registers, and their contents remain throughout. Contents of 
registers not described are considered destroyed. 


Registers 


Base register for the CSECT 

Base register for WORKAREA DSECT 

Base register for CAMLSTD DSECT 

Linkage register for BAL instructions 

Linkage register for BAL instructions > 
\ 


hN OAH 


OS/VS2 CVOL Processor Logic 


CSECT/Subroutine Descriptions 


Each of the CSECTs of the CVOL Processor and the subroutines of CVOL 
Catalog Management are described in this section. The flowcharts are organized 
into two parts. Supporting text for the subroutine appears beside each part. 


Error-condition tests are not shown on the flowcharts. An error condition in 
CVOL Catalog Management results in a branch to label ERRxx, where xx is the 
appropriate error code. There, the error exception code is set, and a branch to 
IGGOCLC7 occurs. The labels on the flowchart are those used in the assembly 
listing. 
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CSECT IGGOCLCA 


IGGOCLCA: First Interface Mapper 


IGGOCLCA is the entry point. Control 

comes from IGGOCLAI or [GGOQ002F 

via an XCTL. 

Registers 

10 Second base register for CSECT 

11. First base register for CSECT 

12 Base register for WORKCLCA 
data area 


Functions 


This CSECT is the entry and exit point for 
the CVOL Processor. After ensuring that the 
PCCB is valid, IGGOCLCA determines what 
type of request has been sent to the CVOL 
Processor and calls the appropriate 
subroutine. 


Internal Subroutines 


For a list of internal subroutines used by 
IGGOCLCA, please see Figure 3-3 in this 
chapter. 


Exits 


Control passes via a branch instruction to: 


e IGGOCLCB from subroutine GENLOC to 
process a VSAM generic locate. 


e IGGOCLCC for all other valid requests. 


Error Conditions 


For a list of error conditions, please see the 
lists of return codes under the heading 
‘‘Processor Exit and Output” at the beginning 
of this chapter. 
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INITIALIZE 
RETURN CODES 
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D1 
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SRCHPCCB 


a | 
DYNAMICALLY 
ALLOCATE CVOL 


E F2 
OSREQ 
OS CAMLST YES 
FORMAT 
REQUEST? 
O 


“EB 


2 
— | 


“B 


H2 
VLOC 
SAM LOCAT 
REQUEST? 
O 


“> 


2 
DELETE 


Lor “FB 


SAM DELETE 
REQUEST? 


Ad 
GENLOC 


“© 


B2 
VLOC 


1 
SET Ree 
TYPE NOT 
SUPPORTED 
RETURN CODE 


SET UP COMMON 
RETURN CODE 


E1 
( RETURN TO ) 
Peter or svc 
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CSECT IGGOCLCB 


IGGOCLCB: Second Interface Mapper 


IGGOCLCB is the entry point. Control 
comes from subroutine GENLOC in the 
IGGOCLCA CSECT. 


Registers 


11 Base register for CSECT 
12 Base Register for WORKCLCA 
data area 


Functions 


CSECT IGGOCLCB produces a list of data 
set names found cataloged under the 
requested high-level qualifiers. 


Internal Subroutines 


CIR provides an interface between 
IGGOCLCB and CVOL Catalog 
Management. 


POINTER updates the current entry pointer 
in the current block. 


Exits 
Control passes to IGGOCLCA via a branch 


instruction with a return code of zero in 
register 15. 


Error Conditions 


Control passes to IGGOCLCA via a branch 
instruction with one of the following return 
codes in register 15: 


Code Reason 


4 Data set(s) not found 
8 Insufficient storage or 
ESTAE macro failed 
12 User’s work area too 
small 
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FROM IGGOCLCA 
NCH 


VIA BRA 


GET_ STORAGE FOR 
INDEX BLOCKS 
AND INITIALIZE 


1 
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P 
LOCATE BY 
WITH HIGH 


NAME 
LEVEL 


QUALIFIERS 


MAINOOA 
CIR 


GET INDEX BLOCK 
WITH LOCATE 


[Ps | 
—| 0 


MAINO1A 


Fl 
POINTER 
GET NEXT ENTRY 
| INDEX BLOCK OR 
TERMINATE 


E E3 
NO PREPARE TO 
TTR ZERO? LOCATE BY TTR 


F3 
STORAGE ———>( RETURN 


3 
GDG BEING YES BUILD GDG LEVEL 
PROCESSED? NAME 
H2 | 
BUILD DATA SET 
NAME 


2 


F 
FREE 


€ 


A 2 
YES PREPARE TO 
TPE? LOCATE BY TTR |-———*® [GET FIRST_ BLOCK 
OF NEXT INDEX 
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B B2 
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D1 
PREPARE TO 
LOCATE BY TTR 
OR 


F 
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CSECT IGGOCLCC 


IGGOCLCO: Initialization 


IGGOCLCO is the entry point. Control comes 
from IGGOCLCA or ICCOCLCB. 


Registers 
On Entry: 


1 Address of caller’s parameter list 
(CAMLST) 
12 Address of Controller III work area 
13. Address of register save area within the 
Controller III work area 


On Exit: 


2 Address of UCB 
4 Base register for this subroutine 
5 Pointer to SVRB extension 
6 Base register for WORKAREA DSECT 
8 Base register for CAMLSTD DSECT 
9 Address of CVT 
12 Linkage register for BAL instructions 
13. Base register for BLDLAREA 
14 Linkage register for BAL instructions 


Functions 


WORKAREA is the common workspace and 
communications area for all CVOL Catalog 
Management subroutines. (WORKAREA has 
been modified slightly from the OS/VS2 
Release 1 version. Refer to Chapter 5, ““Data 
Areas,” for a description of WORKAREA.) 
When a locate function is requested, 
WORKAREA is built over the caller’s 
265-byte area, and a second area (called 
BLDLAREA\) is obtained by GETMAIN. 
BLDLAREA is used with the routine 
IECPBLDL. 


When a non-locate function is requested, a 
larger area is obtained by GETMAIN for 
WORKAREA. Part of this area is used for 
BLDLAREA during execution of subroutines 
IGGOCLCO, IGGOCLC1, and IGGOCLC2. 
The BLDLAREA portion of WORKAREA is 
redefined for use as input/output buffers 
thereafter. 


The first 256 bytes of WORKAREA are set 
to zero, which initializes all switches and 
flags. Supervisor addresses and the data set 
name go into WORKAREA, and the data set 
name is separated into its components. 
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BLDLAREA is initialized for use as 
input/output buffers. 


The UCB table is searched for device 
information about the given CVOL Catalog. 
GETMAIN allocates space for a DCB and a 
DEB, and IGC0002H opens the CVOL 
Catalog. 


Note: The OPEN macro instruction is not 
used to open a CVOL Catalog. IGC0002H 
constructs a modified DCB/DEB for use by 
CVOL Catalog Management. No CLOSE 
macro is issued to close a CVOL Catalog. 
FREEMAIN simply releases the main storage 
that is used for the modified DCB/DEB. 


The first component of the data set name is 
used as the search parameter for BLDL. 
Searching begins with the first block of the 
CVOL Catalog. If BLDL returns a CVOL 
pointer entry, an error return code is returned 
to the user. 


Internal Subroutines 


None. 


Exits 


Control passes via a branch instruction to: 


« IGGOCLC1 if the requested function is 
BLDA or LNKX, or if the high-level name 
is an alias. 

e IGGOCLC7 for an error condition. 

e IGGOCLC2 for all other functions or 
conditions. 


Control passes via a branch to IGCQ002H to 
open the CVOL Catalog and returns to this 
subroutine. 


Error Conditions 


Code Reason 


4 Volume not mounted or does not 

contain the CVOL Catalog. 

20 Syntax error in data set name. 

24 Permanent input/output error. 

28 Bad relative track address for the 
CVOL Catalog. 

32 Bad address for caller’s area. 

References 


CVT, TCB, SVRB, DCB, DEB, and UCB are 
described in OS/VS2 Data Areas. 
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IGGOCLCI: Relative GDG and Alias 


IGGOCLC1 is the entry point. Control comes 
from: 


e IGGOCLCO when the requested function is 
either BLDA or LNKX, locate-by-block, 
or when an alias is found (except with a 
DLTA request). 


«e IGGOCLC2 when a relative GDG number 
is found in the data set name. 


Registers 


4 Base register for this subroutine 

6 Base register for WORKAREA DSECT 
8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 
13. Base register for BLDLAREA 
14 Linkage register for BAL instructions 


Functions 


When locate-by-block is requested, the block 
is read and returned to the caller. 


When control comes from IGGOCLC2, 
control goes to label RELGDG for relative 
GDG processing. 


If the requested function is BLDA or LNKX, 
the appropriate entry is constructed and 
control passes to IGGOCLC2 to the update 
subroutines. 


When an alias is discovered, the fully 
qualified name is reconstructed in the caller’s 
name area, using the true name. The name 
table is updated to reflect the change, and the 
high-level name is re-enqueued. 


Control comes from IGGOCLC2 when a 
relative GDG number is discovered in the 
data set name. This subroutine determines the 
absolute GDG name for the data set. If the 
request is a locate function, either the volume 
list for the data set or a new absolute GDG 
name is returned to the caller. Otherwise, an 
error condition exists and IGGOCLC7 is 
invoked. 


The generation number in absolute GDG 
names is complemented before the names are 
added to the generation index. Therefore, the 
most recent entry (the highest generation 
number) is the first entry in the index, the 
second most recent entry is the second entry 
in the index, etc. 
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When the relative GDG number is negative or 
zero, an absolute GDG name from the 
generation index is returned to the caller 
along with the corresponding volume list. 

Zero corresponds to the first entry, —1 
corresponds to the second entry, and so forth. 


When the relative GDG number is positive, a 
new absolute GDG name is created and 
returned to the caller. If the generation index 
is empty, this name is GOOOn VOO (where n is 
the relative number). If the generation index 
is not empty, the relative GDG number is 
added to the generation number of the first 
entry to create the new absolute GDG name. 


Internal Subroutines 


CALLBLDL calls BLDL routine via entry 
point IECPBLDL. 


Exits 


Control passes via a branch instruction to: 


« IGGOCLCA or IGGOCLCB after relative 
GDG processing. 


¢ IGGOCLC7 for error conditions. 


e IGGOCLC2 for all other functions or 
conditions. 


Error Conditions 


Code Reason 
8 Name not found for locate function, 
or existing structure inconsistent with 
request for non-locate function. 


20 Syntax error in data set name. 


28 Permanent I/O error. 
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IGGOCLC2: Locate 


IGGOCLC2 is the entry point. Control comes 
from: 


e IGGOCLC1 after resolving an alias or 
constructing and entry for BLDA or 
LNKX request. 


e IGGOCLCO for all other functions or 
conditions. 


Registers 


4 Base register for this subroutine 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 
12 Linkage register for BALR instructions 
13. Base register for BLDLAREA 
14 Linkage register for BALR instructions 


Functions 


This subroutine completes the locate 
functions, or finds the last valid index level 
for a non-locate function. IECPBLDL 
(BLDL) is used to search index levels 
successively. At each index level, one 
component of the data set name is used. 
When locate-by-name is requested, BLDL is 
used with each component of the data set 
name as the search parameter. When BLDL 
returns an index pointer entry (IPE), 
IGGOCLC2 uses it to determine the track 
address for the next search. The search by 
BLDL continues with the next component of 
the name. 


When BLDL returns a data set pointer entry 
(DSPE) or volume control block pointer entry 
(VCBPE), the corresponding volume list is 
returned to the caller. 


When the request is for a non-locate function 
and BLDL fails to find the next level, the 
update process is initiated. 


The last valid level of the existing index 
structure is saved to use while updating. 


IGGOCLC2 contains skeletal channel 
programs that are used by the non-locate 
subroutines. These CCW chains are moved to 
BLDLAREA. 
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CONTROL IS PASSED 
VIA BRANCH 
IGGOCLC2 


A2 
FROM IGGOCLCO 
OR IGGOCLC1 


B 
NTRY FOUND 
IN IGCOOO2F 
YES 


©. 


UCATCHK 
Cc 
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UCATDX 


1 
UCATDX 
MAINTAIN TRAIL 
FOR UCATDX 
ET 


ANALTYPE 


NTRY FOUND 
OR FUNCTION 
TYPE 


VCBPE---> E2 


ES 
ALIAS-~--> F3 
IPE ----> F3 
GIPE----> G1 
LOCATE-->02A1 
| | DSPE----> E] 


DSPE 
E1 E2 
RETURN DATA SET CALL BLDL TO 
POINTER (DSPE) READ VOLUME 
TO CALLER'S LIST INTO 
AREA CALLER'S AREA 


FREERES 
Fl 


F 2: 

DER FREEMAIN, BRANCH TO 
FREE DCB DEB, |——~ IGGOCLCA OR 
AND CLEAN-UP IGGOCLCB 

2 


SAVE GIPE BLOCK 
AND TTR FOR 
UPDATE NEXTLVL) 


REQUEST 
LOCATE 
FUNCTION 


CHECKLVL RESLEVEL FINDNAME 


H H3 
CALL BLDL TO 
GET NEXT LEVEL READ NEXT 
MORE LEVELS NAME - ABSOLUTE] | | LEVEL INDEX 
(RTN NEXTLVL) BLOCK 
0 
IGGOCLC1 | 


BRANCH TO 
IGGOCLC1 


VS2.03.808 
Internal Subroutines Phy 


UCATDX maintains a TTR trail of blocks 
that can be deleted. 


CLC 3PREP 
A A2 


SAVE TTR FOR SAVE ICE IF IT 
BLDLCALL calls BLDL to search for one LAST “BLOCK READ I= | AS JUST READ 


name. 


TORLTV converts an absolute address to a 
relative track address. 


B1 
SAVE rage LEVEL 
wate we REQUEST 


CATBX 
FUNCTION 


FUNCTION PRIN 
NEXTLV 


NEXTLVL gets the component of the data 
set name in order to search for the next level. 


RACHK performs RACF authorization checking. 


REQUEST 
UCATDX 
FUNCTION 

Exits 
When the request is a locate function, control 
passes to: 


D 
RELOCATE CCWS 
INTO WORKAREA 


FOR USE BY 
LATER MODULES 


e IGGOCLCA or IGGOCLCB along with the 
volume list for the data set name. 


e IGGOCLC1 for relative GDG number. 


El 


When the request is for a non-locate function, AREA AND CCW 


control passes to: 


6) 
e IGGOCLC7 for an error condition. | 


IGGOCLC 3 


‘ F2 
e IGGOCLC3 for all other functions or BRANCH TO 
conditions. 


YES 
RPS DEVICE 


CHAIN FOR RPS 


Error Conditions 


Code Reason UCATDX 
POINTING TO 
WORKAREA 
8 Name not found for locate request, 


existing structure inconsistent with 
non-locate request, or the last entry 
found was a CVPE with locate 
request. DELETABLE 


DO NOT DELETE 1ST OR 2ND TRY Oo BLae 
BLOCK WITH MORE THAN 1 ENT 
FIRST BLOCK IN INDEX CHAI 


NOTDEL 


SAVE TTR F(¢ 


JR 
BLOCK TO UPDATE 
IN WRITETTR 


12 Last entry found was an IPE or alias YES 
with locate request. 


; : Si 1 
16 Non-existent index levels specified. SAVE TTR FOR 2 
BLOCK IN RETURN 
DELTTR 1 
20 Syntax error in data set name. 
28 Permanent I/O error. 
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IECPBLDL: 


JECPBLDL is the entry point. Control comes 
from IGGOCLC1 or IGGOCLC2. 


Registers 


0 BLDL List address 

1 DCB address 
13 400 byte WORKAREA address 
14 Return address 


Functions 


This subroutine searches the CVOL Catalog 
for a name, and returns the information 
stored in the directory associated with each 
name. The format of the directory and of the 
returned information is described in the IBM 
publication OS/VS Data Management 
Services Guide. 


Exits 
Control returns to the caller via a branch 
instruction when IECPBLDL completes its 


function. 


Control returns to the caller via a branch 
instruction for an error condition. 


Internal Subroutines 


None. 


Error Conditions 


Code Reason 
4 Entry not found 


8 Permanent I/O error 
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TEPCBLDL : 
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OR [GGOC 


CLC] CONTROL IS PASSED 

Le Vv BRANCH. 

LABELS INCLUDED ON CHART 
ARE LABELS FROM THE CODE. 


B1 


SET ERROR CODE 
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KY 
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CB Pe : 
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AME FOUND 
IN DIRECTORY 
BLOCK 


END OF 

DIRECTORY 
(HIGH NAME 
FOUND) 


KI 


PREPARE TO 
OBTAIN NEXT 
BLOCK 


01G1 


Al 


GET ENTRY 
INFORMATION 
FROM DIRECTORY 


B1 


MOVE ENTRY 
INFORMATION TO 
USER'S LIST 


El 


MORE 
ENTRIES TO 
PROCESS 


D1 
RETURN TO 
CALLER 


NAME NOT FOUND 
(SET ERROR CODE 
OF 4) 


Program Organization 3-31 


CSECT IGGOCLCD 


IGGOCLC3: Update Initialization and Entry Building 


IGGOCLC3 is the entry point. Control comes CONTROL IS PASSED 
froin: 1GGOCLC3, VIA BRANCH A 
Goa SESH 
e IGGOCLC4 after constructing a DSPE for A 
a CATBX request. 
e IGGOCLCS after writing a volume control | 
block and constructing a VCBPE for a B2 
CATBX function. RE NOT PRESENT 
e IGGOCLC2 for all other functions or baie 
conditions. | 
Registers A are 
4 Base register for this subroutine | "TRDEX IF | 
6 Base register for WORKAREA DSECT 


8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 


14 Linkage register for BAL instructions D2 
VOLUME 
When entry is from IGGOCLC4 or 
IGGOCLCS, index levels for a CATBX 
READVICE 


request must be built. Control goes to label E—— 
CATBX on the next subchart. Pesvator 
When control comes from IGGOCLC2, the 


index control entry (ICE), if not already 
present, and volume index control entry 


Fi F 
(VICE) are read. The request is checked hig SEB YES RE-OPEN 
against available space in the CVOL Catalog RETO EXTENTS” 
to ensure that there is enough space to make © 
the required changes. | 


SPACECHK 
This module constructs new index levels for a : 
CATBX function and constructs an index 
pointer entry for the new level to be added to 
the existing structure. When the requested 
function is DRPX or DLTA, the entry to be 
removed is named and IGGOCLC6 deletes it. 


ADDING TO 
SYSCTLG 


FULLCHK 


ENSURE THAT 
THERE IS ENOUGH 
ROOM TO ADD NEW 

ENTRIES 


When CATBX is requested, IGGOCLC4 is 

called to construct the DSPE. Control returns “PE 
to IGGOCLC3, where the required index 

levels are built and written into the CVOL 

Catalog. Each level results in an index 

pointer entry (IPE) that must be added to the 

next higher level. When an existing level is 

reached, control passes to IGGOCLC6. 


IGGOCLC3 routes the update request to the 


subroutines that perform the appropriate 
function. 
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C 


Internal Subroutines 


MOVELVL gets the component of the data 
set name for the current index level from the 
name table. 


WRTSRCH writes a new block to the CVOL 
Catalog and searches for another available 
block. 


KEYICE constructs a new index block, with 
its ICE and key. 


TOABSL converts a relative track address to 
an absolute track address. 


TORLTV converts an absolute -track address 
to a relative track address. 


IO1 performs EXCP input/output. This 
subroutine invokes IGC0002H if a new 
extent of the CVOL Catalog is required. 


Exits 


Control passes via a branch instruction to: 


« IGGOCLC4 when the requested function is 
CATBX, CAT, RECAT, or UNCAT. 


« IGGOCLCS when blocks of the CVOL 
Catalog need to be freed, or when new 
blocks have been written, but the 
requested process has been aborted. 


e IGGOCLC7 for error conditions. 


e IGGOCLC6 for all other functions or 
conditions. 


Control passes via a branch to IGC0002H 
when a new extent of the CVOL Catalog is 
required or when the CVOL Catalog must be 
re-opened, and returns to this subroutine. 


Error Conditions 


Code Reason 


8 Existing structure is inconsistent with 
the requested function. 
12 Attempt to delete a non-empty index 
level. 
20 Not enough space available in the 


CVOL Catalog to perform the 
requested function. 
28 Permanent I/O error. 


| EN TO SET 
MUST COMPLETE 
FUNCTION ON 


MOVENTRY | 
B2 
INSERT _NEW 
ENTRY 


2 
WRITE THIS BUILD KEY AND 
BLOCK AND FIND ICE FOR NEW 
NEW FREE BLOCK INDEX (RTN 
(RTN WRTSRCH) KEYICE) 


D3 
WRITE THIS 
MOVE UP TO NEXT BLOCK AND FIND 


LEVEL OF NAME A_ NEW FREE 
(RTN MOVELVL) BLOCK (RTN 
WRTSRCH) 
E1 
BUILD KEY AND 
ICE FOR NEW ORE LEVEL 
INDEX (RTN TO BUILD 
KEYICE) 
BLDXCHK 
F2 F 
BUILD GIPE AND NO 
FLAG FOR EMPTY BLDX FUNCTION 


AND DFLETE 


< 
©) 


ROUTE é BDLTARTN | 

READ ICE BLOCK 
AN P 
ALIAS COUNT 


(RTN I01) 
Gen De cee 
TO FREE- 
UCATD&--> 
CAT "==> > 
IGGOCLC5 
L H2 
BRANCH TO 
B IGGOCLC5 


DLTA----> 


(2)_ 


IGGOCLC4 | IGGOCLC6 


2 
BRANCH TO BRANCH TO 
IGGOCLC4 


IGGOCLC6 
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IGGOCLC4: Entry Building 


IGGOCLC4 is the entry point. Control comes 
from IGGOCLC3 when the requested 
function is CAT, CATBX, RECAT, or 
UNCAT. 


Registers 

4 Base register for this subroutine 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 


Functions 


If the requested function is RECAT or 
UNCAT, control passes to label ALTERTN. 
If the request is for CAT or CATBX, control 
passes to label CATRTN. 


This subroutine constructs a new DSPE or 
VCBPE. When there are more than five 
volumes in the volume list, IGGOCLCS is 
invoked to write volume control blocks. 


If the data set name is not for a generation 
data group, control passes to label 
CULMINAT. Part two of the flowchart deals 
with cataloging functions to a generation 
index. The new member of a GDG is 
checked against existing members to see if 

- this is a new version of an existing member. 


If the maximum number of entries that a 
generation index can hold is exceeded with 
this addition, the EMPTY and DELETE 
options for GDG are processed. 


If EMPTY was specified, IGGOCLCS will 
remove all entries from the generation index 
before adding the new entry. Otherwise, 
IGGOCLCS will remove only the oldest entry 
before adding the new entry. IGGOCLC4 
flags what is to be done. 


If DELETE was specified, IGGOCLC4 issues 
the SCRATCH macro instruction on every 
data set name that will be removed by 
IGGOCLCS. If DELETE is not specified, 
nothing is scratched. 


The RECAT and UNCAT functions are 
processed by naming the old entry. 
IGGOCLC6 deletes the old entry when it gets 
control. For RECAT, a new entry is also 
constructed. IGGOCLC6 adds this new entry 
to the CVOL Catalog. 
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CONTROL IS PASSED 
VIA BRANCH 
IGGOCLC4 
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ORE 
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IF CATBX 
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D1 
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(RTN BLDENTRY) 


CULMINAT 


E3 
BUILD DSPE OR 
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(RTN BLDENTRY) 
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> 
NEXTLOAD 
F F 
ORE THAN YES NEED TO 
VOLUMES WRITE OR FREE 
BLOCKS 
O 
Be 02C3 
IGGOCLC3 IGGOCLC5 IGGOCLC6_, 


1 2 3 
BRANCH TO BRANCH TO BRANCH TO 
IGGOCLC3 IGGOCLC5 IGGOCLC6 


H2 
UPDATE GIPE AND 
FLAG TO DELETE F 


VCB’'S_ IF VCBPE RE-WRITE_IN 
PRESENT IGGOCLC5 


.. 
CHEKGDG 
J J 
GDG 
PROCESSING 


VCBSNONE 


Internal Subroutines 


TOABSL2 converts an absolute track address 
to a relative track address. 


IO2 performs EXCP input/output operations. 


GET reads a block from the CVOL Catalog 
into the input buffer of BLDLAREA. 


SETUP points to the first and last entry in an 
index block. 


INCR bumps the pointer to the next entry in 
an index block. 


BLDENTRY constructs a data set pointer 
entry (DSPE) or a volume control block 
pointer entry (VCBPE). 


SCRATCH performs a SCRATCH macro 
instruction for one data set and its VCBs. 


Exits 


Control is passed via a branch instruction to: 


« IGGOCLC3 when CATBX is being 
performed. 

e IGGOCLCS when auxiliary reading or 
writing is required: 


— Volume control blocks (VCBs) need to 
be written. 

— VCBs or index blocks need to be freed. 

— The DELETE option of a GDG needs 
to be performed. 

— Updated GDG index blocks need to be 
rewritten. 


« IGGOCLC7 for error conditions. 
e IGGOCLC6 for all other functions or 
conditions. 


Error Conditions 


Code Reason 


8 Existing structure is inconsistent with 
requested function. 
16 Non-existent index level required. 


24 Improperly named GDG data set, or 
GDG data set to be added is older 
than existing GDG data sets. 

28 Permanent I/O error. 
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.) 
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IGGOCLCS: First Load of Update 


IGGOCLCS is the entry point. Control comes 
from IGGOCLC3 or IGGOCLC4 when blocks 
of the CVOL Catalog need to be written or 
freed. 


Registers 


4 Base register for this subroutine 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 


Functions 


ENQ is reissued to ensure that any changes 
to the CVOL Catalog will be completed. 


This subroutine consists of a series of tests 
for required functions. Each test calls the 

appropriate internal subroutine to perform 
one function if it is required. 


Chains of volume control blocks (VCBs) and 
index blocks are freed if possible; that is, they 
are set to zeros and rewritten into the CVOL 
Catalog. They then have a key of zero, 
indicating that they are available for use. 


If changes have been made to a generation 
index, the block containing the generation 
index pointer entry (GIPE) must be updated. 
Likewise, the last block of the generation 
index may need to be rewritten. 


If a generation index reached its maximum 
number of entries in IGGOCLC4 and the 
EMPTY option was specified, that option is 
processed. IGGOCLC4 will have already 
processed the DELETE option. 


If the generation index is full and the 
EMPTY option was not specified, the name 
with the lowest generation number (the oldest 
data set) is removed from the index. 


An UCATDX request can result in unneeded 
index blocks. Such blocks are freed. 


If a CATBX function is requested and the 
volume list contains more than five volumes, 
volume control blocks are constructed from 
that list and written to the CVOL Catalog. 
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IF REQUIRED REQUIRED 
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RETURN 


O 
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FREE A CHAIN 
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B 
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B 3 
FRBLKRTN 


FREE ONE BLOCK 
OF VCB CHAIN 


3 
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Cc 


ORE BLOCK 
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FRVCBEND 
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FREEMAIN 
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BLOCK 
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F 
WRITE ZERO KEY 
AND DATA 
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2 
OINT TO FIRST 
ENTRY 
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RETURN ) 


CHECKS 
WRLSTRTN 


RETURN 


WRITE THE LAST 
BLOCK OF A 
GENERATION INDEX 


2 | 
3 
WRITE LAST 
BLOCK OF GDG _—_——_ RETURN 
CHAIN 


J 


Internal Subroutines 


WRBLKRTN, WRLSTRTN, EMPTYRTN, 
FRNDXRTN, FRVCBRTN, FRBLKRTN, 
and BLVCBRTN are shown on the flowchart. 


SETUP points to the first and last entry in an 
index block. 


INCR increments the pointer to the next 
entry in an index block. 


TOABSL converts a relative track address to 
an absolute track address. 


TORLTV converts an absolute track address 
to a relative track address. 


IO3 performs EXCP input/output operations. 
This subroutine invokes [GCO0002H if a new 
extent is required. 


Exits 


Control passes via a branch instruction to: 


« IGGOCLC3 when the requested function is 
CATBX. 


¢ IGGOCLC7 for error conditions. 


« IGGOCLC6 for all other functions or 
conditions. 


Control passes via a branch to IGC0002H 
when a new extent of the CVOL Catalog is 
required, and returns to this subroutine. 


Error Conditions 

Code Reason 

20 Not enough space available in the 
CVOL Catalog to perform the 


requested function. 


28 Permanent I/O error. 
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CSECT IGGOCLCE 


IGGOCLC6: Second Load of Update 


IGGOCLCG6 is the entry point. Control comes 
from: 


e IGGOCLC4 when the requested function is 
CAT, UNCAT, RECAT, or CATBX. 


« IGGOCLC3 or IGGOCLCS for all other 
requests or conditions. 


Registers 


4 Base register for this subroutine 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 


Functions 


This subroutine adds or deletes an entry to or 
from a given index block, as set up by earlier 
phases, and propagates (ripples) the change 
through the index chain as needed. Each 
entry is taken from the buffer INPUT and 
placed into the buffer OUTPUT until the 
collating sequence of the entry is equal to or 
greater than the name in the update request. 
If the request name is equal, that entry is 
skipped (delete function). If the request name 
is greater, the new entry is merged into 
OUTPUT (add function). Overflow entries 
become an add request for the next block in 
the chain. 


Subroutines named GET and PUT are used 
for input/output. GET reads a block into 
INPUT, a field of WORKAREA, and 
initializes PUT. Entries are transferred from 
INPUT to OUTPUT, another field of 
WORKAREA. When all entries have been 
exhausted from INPUT, another block of the 
index is read from SYSCTLG. 


When OUTPUT is full, a block is written to 
SYSCTLG from OUTPUT by the routine 
PUT. PUT checks all available records before 
writing the block and chooses the record of 
SYSCTLG that is most likely to result in 
contiguous blocks of one index. PUT tries to 
free any unneeded blocks; any unneeded 
block that PUT cannot free is later freed by 
GET. 
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Internal Subroutines 


GET reads one block from an index in the 
CVOL Catalog. 


PUT prepares and writes one block into an 
index in the CVOL Catalog. 


TOABSL converts a relative track address to 
an absolute track address. 


TORLTV converts an absolute track address 
to a relative track address. 


IO1 performs EXCP I/O operations. 


Exits 


Control is always passed to IGGOCLC7 via a 
branch instruction. 


Error Conditions 


The only exception code from this subroutine 
is 28, which indicates that a permanent 
input/output error has occurred. 
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IGGOCLC7: Third Load of Update and Error Handling 


IGGOCLC7 is the entry point. Control 
normally comes from IGGOCLC6, but can 
come from any subroutine of CVOL Catalog 
Management when an error condition is 
discovered. 


Registers 


4 Base register for this subroutine 

5 Pointer to SVRB extension 

6 Base register for WORKAREA DSECT 

8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 


On exit to the caller, the registers (except 
registers 0, 1, and 15) are restored by the 
supervisor. 


Register 15 contains the exceptional return 
code. Registers 0 and 1 contain additional 
information that specifies the type of error 
encountered. 


Functions 


IGGOCLC7 completes the update process. 
The last block of an updated index is written 
to the CVOL Catalog. 


The block containing the index control entry 
(ICE) is read, and the ICE is updated to 
reflect changes to the index. This block is 
rewritten to the CVOL Catalog. 


The block containing the volume index 
control entry (VICE) is read, and the VICE 
is updated to reflect changes to the CVOL 
Catalog. This block is rewritten into the 
CVOL Catalog. 


Tests are made before rewriting any block. If 
the block is both the last block of an index 
and the block containing the ICE, or the 
block containing the VICE, it is rewritten 
only once. 


If an error is discovered, pertinent information is 
gathered from the WORKAREA and placed into an 
environment record and written to the CVOL Catalog. 
If the error is a sequence error, message IEC304I is 
Written to the operator console. If the error is an I/O 
error on a non-locate operation, message IEC302I is 
written to the operator console. The exceptional 
return code is set and all resources are freed. Control 
returns to the caller of CVOL Catalog Management 
via a branch instruction. 
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CONTROL IS PASSED 
VIA BRANCH 
IGGOCLC? 1 A 


A 

FROM IGGOCLC6 ERROR TO 

(NORMAL) PROCESS 
THERS (ERROR) 


LOW LEVEL 
UPDATE 


) 
VIUPDATE | 
2 3 5 
SET FST = 1 IF POSITION VICE 
WRITING FIRST |«————|__ (LIN = 0 BY 
BLOCK DEFAULT) 


FSTCHEK 


LSTCHEK 
D D3 


SET LST = 1 
ADJUST TTR'S§ 


fe) 
ROUTE: TEST FLAGS a 
VFHCHEK 
S E2 

—_). SET VFH = 1 IF 

: . ¢—|]NEED TO UPDATE 

‘ VICE 
j WR 


WRITING 
LAST BLOCK 


oF 


MOVEVICE 


F3 
MOVE VICE TO 
OUTPUT 
(), 


WRITVICE 


o> 


READICE 


1 2 3 
WRITE BLK IN MOVE ICE TO WRITE VICE (RTN 
Ce OUTPUT WRITE) 


oO» 


MOVEICE 


(2), 
WRITICE 
H2 


H1 
READ, UPDATE 
AND WRITE ICE 

BLK (RTNS READ 
& WRITE) 


HERES 


NEED TO 
EXTEND 
CATALOG 


WRITE ICE (RTN 
WRITE) 


J 


UPDATE 
FINISHED 


3 
EXTEND CTLG W/ 
YES SEARCH FOR 
KEY=0, UPDATE 
VICE (RTN 102) 


READVICE 


READ, UPDATE 

AND WRITE VICE 

BLK (RTNS READ 
& WRITE) 


Internal Subroutines 


READ reads one block from the CVOL 
Catalog. 


WRITE writes one block to the CVOL 
Catalog. 


TOABSL converts a relative track address to 
an absolute track address. 


TORLTV converts a relative track address to 
an absolute track address. 


102 performs EXCP input/output operations. 


This subroutine invokes IGC0002H if a new 
extent of the CVOL Catalog is required. 


Error Conditions 


This subroutine returns any exception code 
from another CVOL Catalog Management 
CSECT to the caller. This exception code is 
passed to IGGOCLC7 in WORKAREA. 


The only exception code from this subroutine 
is 28, which indicates that a permanent [/O 
error has occurred. 


Exits 


I1GC0002H may be invoked via a branch 
when a new extent of the CVOL Catalog is 
required. Control returns to this subroutine 
when a new extent has been located. 


Control returns to IGGOCLCA or 
IGGOCLCB via a branch instruction. 


TRANSLATE ERROR 

CODE TO PROPER 

CATALOG ERROR 
CONE 


ee ee a 


ERR: XIT EXIT: DE 
B2 


SEQUENCE 
ERROR 


—- 


LEC 3041 


Cc 


VICE IN 
“ALN STORAGE 


D2 | 
WRITE 

WTO 

IEC3021 


RETURN 
REGISTERS 


D 
CATALOG 
ERROR 8 


rf 


YES 
0) 


CATALOG 
FRROR 2H 


FREERES 


F2 
DER ALL 
RESOURCES 


SAVE REGISTERS, 
LOB 


OPTNCCW 


H 
KEY 


FREEWA | 
H2 


) 
NO 


FREEMAIN 
FIELD 0 WORKAREA 
YES | 
1 | J2 
REATE AND PUT RETURN 
WR CODES INTO 


ITE 
ENVIRONMENT PROPER 
posse REGISTERS 


K 
BRANCH TO 
IGGOCLCA_OR 
IGGOCLCB 
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CSECT IGGOCLCF 


EXTENDB 


IGCOO0 2H A 


ohn a oa FREEMAIN FOR 
IGC0002H: SYSCTLG Open/Extend 9 CRMEN’ =a eo ong 
IGCO002H is the entry point. Control comes . JZ 
from: 
B B3 
« IGGOCLCO or IGGOCLC3 to open a EXTEND REQUESTED Bru AFR NEM 


GETMAIN) 


CVOL Catalog. 


« IGGOCLC3, IGGOCLCS, or IGGOCLC7 
to extend the CVOL Catalog. 
EXTEND 


* Control also comes via an XCTL macro instruction : 
from IGGOS53E after extending SYSCTLG. — 


Registers | 


| 


SW TO 
Patan PASS 


EXTENDC 


GETMAIN FOR 
is TEND MODULE 
(RTN GETMAIN) 


: BLDEB | 
D3 


On Entry for Opening: 


DI 


0 Zero CHECK OB AND INDICATE, PASS eS SE Me 
1] Address of UCB for volume EXISTING EXTEN FUNCTION 
8 Address of CAMLST 
15 Address of area in which to build l=) eae 
DCB/DEB chain 
; E3 
On Entry for Extending: fxIT To CALLER a a 
OF IGCO002H SYSCTEG DATA 
0 Address of DCB for the CVOL SET (RTN I03) 
Catalog 


8 Address of CAMLST 


On Entry after Extending: 
6 Address of SVRB 


7 Address of Extend Work Area ’ 

8 Zero 

9 Address of catalog DCB 
10 UCB address Beginning of DCB 

: —40) 

On Exit: Beginning of Actual 

1 Address of DCB/DEB chain Area Assigned by 

GETMAIN 
Functions | ad 
a0... = _ Words used f 

When this subroutine is entered to open a 12 Cin aaiieanens 
CVOL Catalog, a data control block (DCB) 3g | between Catalog 
and a data extent block (DEB) are built in iv Mangement Nr peules 
the work area provided by IGGOCLCO. If 0 _ Beginning of DEB 
the catalog is new, IGGOCLF2 is invoked to “4 DCBDEBAD or DEBDEBAD 
format it. _ ; 


Note: The DCB/DEB constructed by this 

subroutine is a modification of that described 

in OS/VS2 Data Areas. These two dlocks are 16 DEBNMEXT 
merged together; that is, they overlap in the : 


same area of main storage, as shown in = Baap ieee 
Figure 3-9. 24 ) 


28 DEBAPPAD 
32. DEBUCBAD 


For SYSCTLG data sets that reside on MSS 
virtual volumes, an acquire for DASD space 
is issued. 


38s DEBSTRCC 
4). DEBSTRHH |42 DEBENDCC 
44. DEBENDHH |46 DEBNMTRK ) 


Figure 3-9. DCB/DEB Built by IGC0002H 
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When this subroutine is entered to cross to 
another extent of the CVOL Catalog, a test is 
made to see if dnother extent already exists. 
If so, WORKAREA is modified accordingly, 
and control returns to the caller. 


When another extent does not exist, the virtual 
storage for the previous DCB/DEB is released 
and a new area is obtained with GETMAIN. 
IGG0553A is invoked to allocate a new extent 
and a new DCB/DEB is built into the new 

area (the catalog is reopened). 


‘Main storage for the DCB/DEB is set to zeros 
before building; then only the fields that are 
shown are filled in. The DEB overlays the 
DCB at offset 40. The fields that are named 
are described in OS/VS2 Data Areas. 
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Internal Subroutines 


GETMAIN gets main storage for the 
DCB/DEB. 


IO performs EXCP input/output operations. 


Exits 
Control returns to the caller via a branch 


instruction when IGCO002H completes its 
function. 


Control returns to the caller via a branch 
instruction for an error condition. 


Control passes via XCTL to IGGO553A when 
another extent is required. Control returns 
via XCTL to entry point IGCO002H. 


Control passes via a branch instruction to 
IGGOCLF2 when either the CVOL Catalog or 
a new extent needs to be formatted. Control 
returns directly to the caller. 


Error Conditions 


Code Reason 


4 No extents are allocated or acquired. 
8 No more extents are available. 
12 Permanent I/O error. 


EXTENDAA 
Al 


CONSTRUCT A 
DUMMY JFCB 
FOR DADSM 


Bl 
BUILD IOB, 


DCB/DEB. SET 


EXTENT FLAGS 
ETC. 


Cl 
XCTL TO 
1GG0553A 


FREEMAIN FOR 


UNUSED SPACE 


H 


FORMAT 
H 


SWITCH ON 


RETURN TO 


CALLER OP| 
TGCOO024 
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1ST OR 2ND 
PASS OF EXTND 


2ND 


B3 


SET FORMAT 
SWITCH 


MSS ACQUIRE [| 
PARAMETER LIST 


DEVICE 


CALC EXTENT 
ENTRIES FOR 


MOVE THESE INTO 
EXISTING DEB AND 
INTO MSS PARM 
LIST AS NECESSARY 


G2 
ACQUIRE DASD 
SPACE FOR 

VIRTUAL VOLUME 


H2 


GETMAIN FOR 
FORMATTER 
WORKS PACE 


2 


3 
SET CATALOG 
FORMAT REQUEST |——-———» TeGOc LFS” 
CONTROL PASSES TO CALLER 
OF IGCOO02H WHEN 
IS FINISHED een oes 
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CONTROL IS PASSED 
VIA BRANCH 
IGGOCLF2 
ENTERED FROM 
IGCNOO2H 


IGGOCLF2: SYSCTLG Formatter 


IGGOCLEF2 is the entry point. Control comes | 


from IGC0002H. 


Registers - 


Q Contains zeros when formatting the 
CVOL Catalog 


1 Address of DCB for this data set 


2 Number of blocks per track for this 
device 


THIS LOOP FORMATS 


3 Number of bytes in work area passed to SYSCTEG RECORDS 


IGGOCLF2 CTLGEMT 


D 
END OF 
EXTEND BEEN 
REACHED 
No) 
CTLOUP 1 | 
E1 


WRITE FULL 
TRACK OF 
FORMATTED 

BLOCKS (RTN [i))} 


5 Data management count decrement 
value 


6 Starting relative track address (TTR) 
when formatting the CVOL Catalog 


7 Address of work area 


Functions 


The data set is formatted into 256-byte 
blocks with 8-byte keys. 


If the extent is being formatted during an 
open CVOL Catalog request, this is the first 
extent of a new CVOL Catalog. The first 
block is initialized by writing a volume index 
control entry (VICE) into it. 


If formatting is not being done for the first 
extent, this is a new extent of an already 
existing CVOL Catalog. The VICE is read, 
updated, and rewritten to reflect the new 
extent. 


The work area that is passed to IGGOCLF2 is 
freed before exit. 
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Internal Subroutines 


CNVT converts a relative track address to an 
absolute track address. 


IO performs EXCP input/output operations. 


RELOC builds channel programs for 
input/output. 


Error Conditions 


IGGOCLF2 returns one exception code, 12, 
which indicates that an I/O error has 
occurred. The caller of CVOL Catalog 
Management never sees this code. 


Exits 


Control is passed to the caller of IGCO002H 
via a branch instruction. 


a 01D1 
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BACK UP_1 TRK 
TO PASS LAST TT 
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PDATE 
DIRECTORY 
CONTROL BLOCK 
(RTN IO) 


EXTNDA 


UPDATE 
INFORMATION IN 
WORKAREA FOR 
CATALOG EXTENTS 


D1 D2 


SET FORMATTED 


SET UP NEXT TT SWITCH IN DSCB 


E1 
UPDATE VICE IN 
DATA SET 


E 2 


WRITE BACK THE 
DSCB (RTN IO) 


EXTENDED ‘ 


FREEMAIN 


PROVIDED BY 
iGC0002H 


EXIT IS _ TQ CALLER 
OF IGC0002H 


H1 
RETURN VIA 
BRANCH 


Program Organization 


3-45 


Microfiche Directory 


VS2.03.808 


This chapter contains a directory to the microfiche listings for all the CSECTs 
and subroutines used by the CVOL Processor. This directory describes the 
contents of each CSECT and allows you to quickly find any desired code. 


CSECT IGGOCLCA is written in PL/S-2, a high-level, proprietary system 
language. Listings produced for microfiche consist of the PL/S-2 source code, a 
cross-reference and attribute table, and the assembly code. See the IBM 
publication Guide to PL/S IJ for a more detailed explanation of PL/S and 

its listings. 


CSECTs IGGOCLCB, IGGOCLCC, IGGOCLCD, IGGOCLCE, and IGGOCLCF 

use Assembler language. Listings produced for microfiche consist of the Assembler 
source code, a cross-reference and attribute table, and the assembly code. For more 
information on Assembler language, see the IBM publications OS/VS-DOS/VS-VM/370 
Assembler Language and OS/VS-VM/370 Assembler Programmer’s Guide. 


Note: The listings use CPL, FVT, and FPL instead of CTGPL, CTGFV, and 


| CTGFL, respectively. See OS/VS2 Catalog Management Logic for a 


description of these data areas. 


In the following tables, the CSECT name appears in the first (leftmost) column. 
The second column contains an entry-point label or a subroutine label (internal 
procedure). The third column differentiates between entry points (EP) and 
procedures (PR). The fourth column describes the subroutine. For more 
information on the CSECTs and subroutines, refer to the following chapters in 
this publication: *‘Method of Operation” (Chapter 2), and ‘‘Program 
Organization” (Chapter 3). 
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CSECT | Subroutine | Use. Description 


IGGOCLCA CVOL Sharing Interface Mapper CSECT 1. This 
module is the first of two CSECTs that map VSAM 
and OS catalog functions to CVOL Catalog 
Management. 


OS/VS2 CVOL Processor Logic 


IGGOCLCA | EP |Main entry point for thisCSECT. _ 
IGGOCLIA EP |Dynamically allocates a CVOL Catalog. 
DELETE fist 
accomplished by issuing an OS UCATDX request and 
optionally a SCRATCH SVC. 
_DSCBTTR PR_|Processes a ‘DSCBTTR’ CTGEL. 
DSTYPNAM | PR |Processes a ‘DSTYPNAM’ CTGEL. 
ENTNAME | PR /Processes an ‘ENTNAME’ CTGEL. 
ENTYPE PR_|Processes an “ENTYPE| CTGFL. 


ESTAEXIT PR |Processes an ESTAE intercepted abend. _ 


FPLMV PR |Processes the following repeating field CTGFLs: 
DEVTYP, VOLSER, FILESEQ, and CATVOL. 


GENLOC PR |Processes a VSAM -like generic locate. Most of the 
processing is done by the second CSECT of the 
Interface Mapper (IGGOCLCB). 


GETSVCK PR |Changes storage key via MODESET macro from user 
key to SVC key. 


GETUSERK | PR /|Changes storage key via MODESET macro from SVC 
key to user key. 


LOCNAME PR tse an OS LOCATE by NAME request. 
PR 


Processes a VSAM-like delete request. This is 


LOCTTR Issues an OS LOCATE by TTR request. 
OSREQ Sets up and executes an original OS CAMLST format 
request. 


RESCAN PR |Searches the CVOL Catalog and determines if the 

specified data set is a generation data group type. If a 

generation index pointer entry (GIPE) is found, the 

GIPEPTR contains the address of the GIPE. 

Otherwise, the GIPEPTR contains zeros to indicate the 
____|absence of a GIPE. 


SLGDG PR |Processes a SUPERLOCATE generation data group 
request with the base generation number supplied. 


SLGDGB PR |Processes a SUPERLOCATE generation data group 
request to return the generation data group base value. 
SLGDGBL PR |Searches for a new absolute generation number if the 


| supplied relative generation number ts less than zero. 
SLNAME PR |Processes a normal superlocate request or a GDG ALL 


SLVOLST PR |Fills the user's volume list area with volume serial 
numbers, device types, and file sequence numbers. 


SRCHPCCB | PR |Searches the PCCB (Private Catalog Control Block) 
chain to see it a PCCB for the needed catalog is 
already on the chain. If it is, the PCCBPTR points to 
it. If there is no PCCB, the PCCBPTR is zeroed. 


SUPERLOC | PR |Determines type of superlocate request and calls the 
appropriate procedure: SLGDG. base generation 
number supplied; SLGDGB, base only requested: or 
SLNAME, normal SUPERLOCATE. 


VLOC PR |Processes a VSAM LOCATE or an Access Method 
Services LISTCAT. 


CSECT 


IGGOCLCB This is the main processing module for Generic Locate. 
It searches the SYSCTLG data set using CVOL 
Catalog Management LOCATE and returns the names 
of all data sets that are found to have the requested 
high level qualifiers as the first part of the data set 
name. 


IGGOCLCB | EP |Only entry point for this CSECT. 


CIR : This subroutine is a modified version of the OS/VS2 


Release 1 module IKJEHCIR, which was used for the 
TSO LISTCAT command. CIR does the actual locates 
and builds the lists of qualifiers to be processed for 
CSECT IGGOCLCB. 


CODEO0O PR This subroutine gets control if LOCATE passes a 
return code of zero. 


DSNAMRT This subroutine gets control when a data set entry is 
found in the list from CIR. DSNAMRT checks to 


determine if a generation data group is being 
processed. If so, the generation portion of the simple 


name must be complemented. 
INDEXRT This subroutine gets control when an index entry is 
discovered in the list from CIR. It sets up a parameter 
list for CIR and uses subroutine OBTBLK to allocate 
another block for a new list of lower qualifiers. The 
the current CIR list. 
MAINOO This subroutine checks for a null list and returns to the 
caller with a return code of 4 if the index structure 
specified or the USERID had no data sets cataloged 


GDGROUT This subroutine is entered if a generation data group 
- entry is found in the CIR list. It turns on the GDGSW 

switch so that the data set name entry routine 
(DSNAMRT) will know that the generation number in 
the simple name will need complementing. A check is 
made to see if any generations exist. If not, this entry 
is skipped. If any generations exist, the count of the 
number of generations cataloged is kept and 
decremented each time a generation name is processed. 
Control is passed to the index entry routine 
(INDEXRT) to read in the list of names through CIR. 
Register 6 points to the current entry. 
new list is made current, and CURNTBLK points to 
under it. 


Entry is made to this subroutine with register 6 
pointing to a new list element or entry. The list entry 
is analyzed and the appropriate routine is used to 


process it. Data set name entries are used to complete 
fully qualified data set names, and are returned in the 
caller’s output area. 


MAINO1 
This subroutine is used to obtain a new block to be 
used as a work area for CIR and to become the current 
block. If no free blocks are available, a conditional 
GETMAIN is issued and the new block is added on the 
chain. If the GETMAIN fails, control is returned to 


OBTBLK 
caller with a return code of 8. 


POINTER This subroutine updates the current entry pointer in 
the current block. The current block is determined by 
searching the chain for the first block with a zero entry 
pointer and then backing up one. The current entry 
type is determined, and the pointer is advanced 
accordingly. If the next entry is a link entry which 
contains a non-zero TTR, the CIR is called to provide 
the next block of entries. If the TTR is zero, the 
current block is released and the preceding block is 
considered. When all blocks are processed, that is, the 
current block equals the first block and the empty 
block equals zero, the WRAPUP routine is entered. 
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CSECT_| Subroutine | Use 


VCBROUT | PR |This subroutine is given control when a volume control 
block (VCB) entry is found in the list from CIR. A 
check is made to determine if a generation data group 
is being processed. If so, the generation portion of the : 
simple name must be complemented. If there is no } 
generation data group, the simple name is not 

plemented. 


WRAPUP This subroutine gets control when processing for 
IGGOCLCB is completed or an error resulting in 
termination occurs. It frees all the dynamic core 
obtained for IGGOCLCB. 
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CSECT | Subroutine [Use] Description 


IGGOCLCC CSECT IGGOCLCC performs the read operation for 
CVOL Catalog Management. It performs the locate 
functions and the locating part of the non-locate 
functions. 


IGGOCLCC EP |Only entry point for CSECT IGGOCLCC. 


IGGOCLCO This subroutine initializes the work areas, opens the 
given CVOL Catalog, and searches for high level 
IGGOCLC1 


IGGOCLC2 PR |This subroutine searches lower levels of the name, 
saves last valid index levels, and relocates CCWs for 
use by CSECTs IGGOCLCD and IGGOCLCE. 


IECBLDL PR |This subroutine searches for the qualified name in the 
CVOL Catalog. 


Performs RACF authorization checking via RACHECK 
RACHK macro for UNCATLG, RECATLG, DRPX, and 
CATLG-GDG requests. 


This subroutine resolves aliases, constructs BLDA or 
LNKX entries, and processes relative generation data 


IGGOCLCD CSECT IGGOCLCD performs the setup operation. It 
checks the validity of the requests against the existing 
entries in the CVOL Catalog. It builds new entries to 
be added to the catalog, or it names entries to be 
deleted. 


IGGOCLCD | EP [Only entry point for CSECT IGGOCLCD. 


IGGOCLC3 PR |This subroutine ensures that VICE, ICE, and space are 
present. It constructs and writes new index blocks, and 
routes non-locate requests. 


IGGOCLC4 


" IGGOCLCS | 


IGGOCLCE | E 
IGGOCLC6 


IGGOCLC7 : 


IGGOCLCF 


IGC0002H 7 


IGGOCLF2 PR | This subroutine formats new extents of a catalog. 


This subroutine constructs new DSPEs or VCBPEs. It 
scratches generation data groups if requested. The 

EMPTY option for generation data groups allows the 
existing generations to be scratched before adding new 
ones. 


This subroutine frees index blocks, frees volume 
control blocks, and writes new volume control blocks. 
It also performs the EMPTY option as requested. 


CSECT IGGOCLCE performs the write operation. It 
merges entries into SYSCTLG blocks, deletes entries 
from blocks, and does most of the writing that is 


IGGOCLCE 


point for CSECT iGGOCLCE. 


This subroutine updates blocks, writes updated blocks 
to SYSCTLG, and ripples a change as needed to the 
last block of the updated chain. 


This subroutine writes the last updated block, updates 
the control entries, returns control to CSECT 
IGGOCLCA. or IGGOCLCB, whichever called CSECT 
IGGOCLCC. This subroutine also handles all error 
conditions for CSECTs IGGOCLCC, IGGOCLCD, and 
IGGOCLCE. 


CSECT IGGOCLCF performs three functions: it opens 
CVOLs, extends CVOLs, and formats new extents. 


Main entry point for CS9ECT IGGOCLCF. 


This subroutine opens the SYSCTLG data set and gets 
the next extent of that data set. For SYSCTLG data 
sets which reside on MSS virtual volumes, it acquires 
the DASD space using SVC 26. 
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The data areas and record formats in this chapter are described in four columns, 
which are interpreted as follows: 


Offset 


The numeric address of the field relative to the beginning of the area. The 
first number is the offset in decimal, followed (in parentheses) by the 
hexadecimal equivalent. 


Bytes and Alignment 
The size (number of bytes) of the field and its alignment relative to the fullword 
boundary. 


Examples: 
4 A 4-byte field beginning on a word boundary. 
.3 A 3-byte field beginning on a halfword boundary and running into the 
next word. 


.2 A 2-byte field beginning at the low-order byte of a word and running 
into the next word. 


Name and Content 
A name that identifies the field. This name appears as a label in the assembly 
listings. 


This column is also used to show the contents of the field or the bit settings of 
flag fields (the state of bits in a byte). When the column is used to show the 
state of the bits (O or 1) in a flag byte, it is shown as follows: 


ciecrees The 8 bit positions (0-7) in a byte. For ease of scanning, the 
high-order (leftmost) 4 bits are separated from the low-order 4 bits. 

> ee A reference to bit 0. 

| eeeeee Bit 0 is on. 

6 agence Bit 0 is off. 

ree xx A reference to bits 6 and 7. 


Bit settings that are significant are shown and described. Bit settings that are 
not presently shown are understood to be reserved bits. 


Field Description and Meaning 
The use of the field. 


SYSCTLG Entry Formats 


This section describes the formats of the entries of SYSCTLG, along with the 
symbolic labels that are used to refer to their fields. The entries are arranged 
alphabetically. 


Except for the volume control block (VCB), SYSCTLG entries have a similar format. 
These entries share a common definition for the first 12 bytes. The shared names 
are: 


ENAME ETTR ETYPE 
(8 bytes) (3 bytes) (1 byte) 


Individually named fields follow either ETTR or ETYPE. 


The entries in a SYSCTLG block begin in the third byte of the block. The first 
halfword of the block contains the binary number of the bytes that are used in this 
block, including the halfword count field. 
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Alias Entry (AE) 


An alias entry defines an alternate name for the high-level qualifier of a data set 


name. 


0(0) 


Control Volume Pointer Entry (CVPE) 


Bytes and 
Alignment 


Name and 
Content 


ETYPE 
X'04 


ETRUEN 


Field Description and Meaning 


Name: contains the alias of the high-level 
index whose relative track address ts found al 
offset & of this entry. 


Address: contains the relative track address 
(TTR) of the first block of the index named at 
offset 12 of this entry. 


Type: indicates that this is an alias entry: also 
that four halfwords follow in the remainder of 


|the entry. 


True name: contains the name of the index 
whose alias appears at the beginning of this 
entry. 


A control volume pointer entry can appear only in volume indexes. Two forms are 
possible: the old form, created prior to Release 17 of IBM System/360 Operating 
System, and the new form, created since that release. Both forms are shown here. 


Old CVOL Pointer Entry 


O(O) 


Bytes and 
Alignment 


3 ETTR Zero field, 


| X1000000" 


Name and 
Content 


ENAME 


Field Description and Meaning 


Name field; contains a high-level name that 
appears in the volume index of the control 
volume identified at offset 12 of this entry. 


New CVOL Pointer Entry 


Offset 
OO) 


Bytes and 
Alignment 


ETY PE 
X*03° 


EVOLIDO 


Name and 
Content 


ETTR 


LX"000000" 


Type: indicates that this is either an old CVOL 
pointer entry (CVPE), or an index control 
entry (ICE). An ICE always appears as the 
first record of an index level: a CVOL pointer 
entry always appears in the volume index. 
This is also the number of halfwords that 
follow in the remainder of the entry. 


Serial number of the control volume whose 
volume index contams an entry for the name 
found at the beginning of this entry. 


Field Description and Meaning 


Name: contains a high-level name that 
appears in the volume index of the control 
[volume identified at offset 12 of this entry. 


Zero field. 


ETYPE 
X05" 


16(10) 
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EDEVTYP 


remainder of the entry. 


— - 


Type: indicates thal this isa new CVOL 
pomter entry (CVPE) or the volume index 
control entry (VICE). The VICE always 
appears as the first entry in the first block of 
SYSCTLG: a CVOL pointer never appears as 
the first entry of the first block. Also 
indicates that five halfwords follow in the 


Control volume device type: contains the 
binary device code of the control volume 
whose volume index contains an entry for the 


EVOLID 


Serial number of the control volume whose 
volume index contains an entry for the name 
found at the beginning of this entry. 


Data Set Pointer Entry (DSPE) VS2.03.808 


A data set pointer entry can appear in any index level. It contains the simple name 
of a data set and from one to five 12-byte fields, each of which identifies a volume 
on which the named data set resides. 


Bytes and Name and 
Alignment Content Field Description and Meaning 


0(0) ENAME Name; contains the simple name of the data 
set whose volumes are identified at offset 12 of 
this entry. 

8(8) 3 EDSCBTTR |Address: contains either binary zero or, when 


the data set resides on only one volume, the 
relative track address (TTR) of the data set 

control block (DSCB) for this data set in the 
volume table of contents (VTOC). 


11(B) | ETYPE Type; indicates that this is a data set pointer 
X‘07° entry (DSPE). Also indicates the number of 
x‘0D’ Thalfwords that follow in the remainder of this 
xX*13° entry. 

x‘ 19’ 
X‘1F’ = 

12(C) 2 EVOLCNT |Volume count; contains the binary count of 

the number of volumes identified beginning at 
7 offset 14. 
14(E) ..12 to 60 EDATA Volume entries; contains from one to five 


12-byte entries, each of which identifies one 
volume on which the data set resides. Catalog 
management neither uses nor checks the 
contents of this field. 


Generation Index Pointer Entry (GIPE) 


A generation index pointer entry can appear in any index except a generation 
index. It corresponds to the simple name used in the relative name for a GDG data 


Set. 
Bytes and Name and 
Alignment Content Field Description and Meaning 


ENAME Name; contains the name of the generation 
index to which this entry points. 
ETTR Address; contains the relative track address of 


the first block of the generation index named 
in this entry, in the form TTR. 


Type; indicates that this is a generation index 
pointer entry (GIPE). Also indicates that two 
halfwords follow in the remainder of this 

entry. 


Flags: contains the options specified by the 
creator of the generation data group: 


DELETE option. 
IEMPTY option. 


EGMAXSIZ |Maximum count: contains a binary number 
_ sera the maximum number of 


generations allowed in the generation index at 
one time. 


EGCURSIZ |Current generation count; contains the binary 
number of generations currently cataloged in 
the index. 


Data Areas 5-1.2 


VS2.03.808 


Index Control Entry (ICE) 


The index control entry is the first entry in all indexes except the volume index. 


Bytes and Name and 
Alignment {Content Field Description and Meaning 


INAME Name: low value of binary | ensures that this 
x‘00...01° is the first entry in the index. 


ILSTBLK Last block address: contains the relative track 
address of the last block assigned to the index, 
in the form TTR. 


Type: indicates that this is either an ICE or an 
old CVOL pointer. An ICE always appears as 
the first entry of an index; an old CVOL 
pointer always appears in the volume index. 


Also indicates the number of halfwords that 
follow in the remainder of the entry. 


IFSTBLK First block address; contains the relative 
address of the block in which this entry 
appears, inthe form TTR. 


ILIASCNT  |Number of aliases; contains a binary count of 
aliases assigned to the index. This count is 
always zero for indexes that are not high-level. 
An index cannot be deleted if this count is 
non-zero. 


16(10) Reserved. 


Index Link Entry (ILE) 


An index link entry is always the last entry in any index block. It is used to link 
blocks of one index into a chain. 


Bytes and (Name and 
Alignment {Content Field Description and Meaning 


Mame; high value (all bits on) ensures that this 
is the last entry tn the index. 


Link address; contains the relative track 
address of the next block of the same index, if 
there is one, in the form TTR. When this ts 
the last (or only) block, this field contains 
binary zero. 


Type: indicates that this is either an ILE or an 
IPE. The name field of an ILE always 
contains X‘FFFFFFFFFFFFFFFF : the name 
field of an IPE never does. Also indicates that 
there are no more halfwords in the entry. 


Index Pointer Entry (IPE) 


The index pointer entry can appear in any index except a generation index. It 
points to a lower index. 


Bytes and Name and 
Alignment | Content Field Description and — 


Index address; contains the relative track 
address of the first block of the index named 


Type: indigates that this is either an IPE or an 
ILE. The name field of an ILE always 

contains X‘FFFFFFFFFFFFFFFF : the name 

field of an IPE never does. Also indicates that 
there are no more bytes in the entry. 
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Volume Control Block (VCB) 


A volume list can be recorded in one or more volume control blocks. Each volume 


control block is one block of the SYSCTLG daia set, and can identify up to 20 
volumes on which one data set is recorded. 


Note: This block is different from other blocks of SYSCTLG. The first halfword 
does not contain the number of bytes used in the block as do other SYSCTLG 
blocks. The field VCBVOLCT, shown below, is the first halfword of the VCB block. 


00) 


2(2) 


242(F2) 


Bytes and Name and 
Offset Alignment (Content Field Description and Meaning 


. 12 to 240 


VCBVOLCT |Number of volumes: contains the number of 
volumes identified in this and subsequent 
volume control blocks. This number ts 
reduced by 20 for each subsequent volume 
control block. For example, if a data set 
resides on 61 volumes, tt uses four volume 
control blocks. This field of each block 
contains 61, 41, 21, and [. respectively. 


Volume identifications: contains from [| to 20 
12-byte entries, each of which identifies one of 
the volumes on which the data set resides. 
Catalog management neither uses nor inspects 
the content of these entries. Each 12-byte 
entry contains a 4byte device code, a 6-byte 
volume serial number, and a 2-byte data set 
sequence number. 


VCBVOLS 


Zero field. 


252(FC) 


| Chain address, contains the relative track 


address of the next volume control block. tf 
there ts One, in the form TTR. If this is the 
last (or only) block of the volume control 
block, this field contains binary zero. 


Volume Control Block Pointer Entry (VCBPE) 


Zero field. 


A volume control block pointer entry can appear in any index. It is used when a 
data set resides on more than five volumes. 


(10) 


Bytes and 
Alignment 


Name and 
Content Field Description and Meaning 


Name: contains the simple name of the data 
set whose volumes are identified in the volume 
control block that is pointed to by this entry. 
Address; contains the relative track address of 
the volume control block identifying the 
volumes containing the data set named in this 
entry, inthe form TTR. 


Type: indicates that this is a volume control 
block pointer entry. Also indicates that one 
halfword follows in the remainder of this 


entry. | 


xX" 0000° Zero field. 
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Volume Index Control Entry (VICE) 


The volume index control entry is always the first entry in the first block of data 
set SYSCTLG. 


It is the control record for the entire data set, and acts as an ICE for the volume 
index. 


Bytes and Name and 
Alignment (Content Field Description and Meaning 
0(0) a VNAME __ |Name; always contains a binary one to ensure 
X‘00...01° _| that this is the first entry of the volume index. 
8(8) 3 VLSTBLK |Last block address; contains the relative track 
address of the last block of the volume index, 
in the form TTR. 
11(B) VTYPE Type; indicates that this is the volume index 
x*05’ 
CVOL pointer is never the first entry. Also 
indicates that five halfwords follow in the 
remainder of the ent 
16(10) 3 VFHOLE _|First available block; contains the relative 
track address of the first unused block in 
SYSCTLG, in the form TTR. 


control entry or a new CVOL pointer entry. 
12(C) 3 VCLSTBLK |Last block of the catalog; contains the relative 
track address of the last block in SYSCTLG, 
in the form TTR. 
1913) | 1 | X'00" [Zero fie. 


first entry of the first block of SYSCTLG; a 
iF) | st | X00" (Zero field, 


The volume index control entry is always the 
14(E) VHIREC _ |Contains the number of TTRs in VCLSTBLK. 
Note that this field is the last byte of 
VCLSTBLK (offset 12). 
20(14) Reserved. 


Environment Record (EREC DSECT) 


The environment record is written by module IGGOCLC7 under certain error 
conditions. This record is useful in diagnosing problems using the catalog 
management routines. Reading the environment record is described in the chapter, 
“Diagnostic Aids.” 


Bytes and 
Alignment aig Field Description and Meaning 


Pom | | Reserved, 


8(8) 8 ERTIME Time stamp, as produced by the TIME macro 
instruction. 


16(10) 4 ERCAMLST | First four bytes of the caller's parameter list 
produced by the CAMLST macro instruction. 
| 2004) | 1: | ERMODMAP |Field MODMAP1 from WORKAREA. 


2105) | 4 | ERFLAG1 [Field FLAGI from WORKAREA. 
2216) | .1. | ERFLAG2_ |Field FLAG2 from WORKAREA. 
23(17) 2 ERFLAG3 [Field FLAG3 from WORKAREA. 


24(18) ERERRCOD |Fields ERRCATSV and ERRLOCSV from 
WORKAREA. 


26(1A) —o ERNAMTTR- Level name, TTR, type, and volcnt; the first 
14 bytes of a general ent 


40(28) ERREGSV |Contents of general registers 0 through 14 at 
the time the environment record is written 
(register 15,is destroyed by module 
IGGOCLC7). 

100(64) ERWAI Contents of WORKAREA from offset 12 
bytes (label TTR) through offset 39 bytes. 


(cont. ) 


5-1.5 OS/VS2 CVOL Processor Logic 


RPSD DSECT 


(cont. ) 


146(92) 


176(B4) 


164(A4) 


212(D4) 


Bytes and (Name and 
Alignment (Content Field Description and a 


128(80) =a ERINPUT _ {First entry in First entryinINPUT. 
| === gs EROOPTNCC. | Field OPTNCCW from WORKAREA. 


VS2.03.808 


EROUTPUT |First entry in OUTPUT. 


ERIOB Field IOB from WORKAREA. 


ERNAME s|Fully qualified name provided by the caller. 


RPSD describes the CCW chain used for rotational position sensing (RPS) 
support. 


Offset 


O10) 


0O(0) 


bs 


Bytes and 
Alignment 


16 


&(8) 
16010) 


16010) 


20014) 


2418) 
28(1C) 


32(20) 


Name and 
Content Field Description and Meaning 


RPSCCW RPSSS and RPSTIC. 
RPSSS 
RPSTIC 


Two double-words: RE 
Set sector CCW. 


TICs to normal channel program. 


16 RPSINPUT | Four words: RPSCNVT, RPSDDKR, RPSRI, 
7 __sjand RPSPTR. ee 

4 a RPSCNVT |Address of supervisor routine to convert sector 

| value. __ 

4 RPSDDKR_ {Block size (DD, 256 bytes), key length (K, 8 


bytes), and record number. 
Address of location of this DSECT during use. 
Type and address: the first byte contains the 
device type code, and the last three bytes 
contain the sector value. 


RPSR| 
RPSPTR 


RPSAVE 


10-word register save area. 


Note: The listings use CPL, FVT, and FPL instead of CTGPL, CTGFV, and 
CTGEL, respectively. Please see OS/VS2 Catalog Management Logic for a 
description of these data areas, as well as PCCBs. 
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WORKCLCA Work Area 


Controller III creates WORKCLCA. The CVOL Processor gains control via an XCTL 
with register 12 pointing to WORKCLCA. For more information on WORKCLCA 
at processor invocation, see Figure 3-1. 


Bytes 
and Bit 
Pattern Field Name Description: Content, Meaning, Use 


oo | 4 fe Reserved 
4 (4) 44 WKCATNM Name of the non-VSAM entry that defines 
the CVOL Catalog in the VSAM Master 
Catalog. 
48 (30) WKCATANM Alias name in the VSAM Master Catalog 
that is related to WKCATNM. 
92 (SC) ee WKCVOLVS Volume serial number of CVOL Catalog. 
9962) | 2 |* Reserved, 
100 (64) ae CVTPTR Address of CVT. 
104 (68) TCBPTR Address of TCB. 
108 (6C) SVRBSAV Address of SVRB. 


112 (70) te dl VSRCI5 VSAM register 15 return code. 


116 (74) REGI3SAV CVOL Catalog Management register 13 
Save area address. 


| os) | 4 |uimir  ————s|Limitof DO Loop sd 
128 (80) 
132 (84) CTGFLPTR 


CAMPLPTR Address of OS CAMLST 


PRMLSTSZ Size of Dynamic Area to be freed for SVC 
26 


72 
216 (D8) 20 


XSAVAREA Save area for all external references. 


WKCAMLST CAMLST build area for calling CVOL 
Catalog Management. 


KOPTNS Option bytes. 


KPTRI Address of data set name. 
KCVOLP Address of CVOL = ZERO. 


Rak 
| 4 
| 2 KPTR3 Address of the CVOL Catalog 
az 
Es 
_ 4 | 


= 


Management output area. 


KDSCBP Address of DSCB TTR 


GIPEPTR Address of Generation Index Pointer Entry 
(GIPE). 


< 


PCCBPTR Address of PCCB. 


SAVERI Save area number of bytes in data set 
name. 


248 (F8) 4 SAVER3 Save area for register 3. 
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Bytes 
and Bit 
Pattern Field Name Description: Content, Meaning, Use 


SAVER6 Save area for register 6. 


252 (FC) 
256 (100) 
260 (104) 
264 (108) 
268 (10C) 
272 (110) 


> i+ 


fs Reserved. 
276 (114) 7 Save area for I pointer. 
return code. 
284 (11C) CVOL Catalog Management register 0 
return code. 
288 (120) 4 One of the following: 
oe 
4 |ENTCOUNT CTGFL entry byte count. 
292 (124) 
296 (128) 
300 (12C) 44 LOCDSN Data Set Name hold area. 
344 (158) 44 WKDSN Data Set Name hold area. 
388 (184) Blank character to stop TRT on WKDSN. 


| 
389 (185) , WKDSCBT DSCBTTR hold area. 


392 (188) KEYTYPE Switch to indicate which key IGGOCLCA 
is currently operating under. X‘00°=SVC, 
X‘FF’=USER. 


393 (189) | OLDKEY MODESET savekey area. 


394 (18A) 7 INCORESW Switch to indicate type of block in storage. 
X‘00°’=NAME, X‘FF'=TTR. 


395 (18B) - DO WHILE controller. 
373 (175) | ENQDEQSW X‘00’=not enqueued, X‘FF’=enqueued 
ueuing on a chain of PCCBs). 
396 (18C) 
& F 


400 (190) 


HOLDINDX 
HOLDFPLN 


..250 WKVOLS Volume entries. 
3 WKNXTTTR TTR to next block. 


...10 * Reserved. 
3 


681 (2A9) Reserved. 
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Field Name Description: Content, Meaning, Use 
CATBX or RECAT only. 

940 (3AC) LKNP LINK name pointer. 

944 (3B0) 


948 (3B8) LKNM Name of module being linked to. 


956 (3C0) | 6 | ESTAELIST ESTAE macro list form. 
972 (3D0) WKTMPCNM Temporary catalog name. 


area) | 2 SOS~*r Reeds SS 
3720 (D98) WKCLIASV IGGOCLIA save area. 


3552 (DEO) 48 WKSHRPRM 
ACCCBP 


Shared parameter area. 


—e 


3552 (DEO) 4 Pointer to Allocate Catalog Control 


DtIONS. 


4 ACCRWPI1 Pointer to ACCRWP2. 
| — ACCJSCBP Pointer to TCBJSCB. 
4 + ACCCATPI Pointer to ACCCATP2. 
4 | ACCALSPI Pointer to ACCALSP2. 
4 ACCDDNMP Pointer to zero. 
_ | 4_| ACCRWP2 _ Pointer to ACCRW. 
; | 4 ACCCATP2 | Pointer to WKCATNM Catalog Name. 
4 ACCALSP2 Pointer to WKCATANM Catalog Alias 
2 - Name. 
4 ACCRW Return data from Allocate Catalog control. 
2 ACCRETCD __| Allocate Catalog Control Return Code. 
ee ahs = | ACCRESCD Allocate Catalog Control Reason Code. 
a ACCCB | Allocate Catalog Control bits. 
2 - Reserved. 
| 16 | 


3552 (DEO) 6 ENQPARMA ENQ/DEQ parameter area. 
3552(DE0) | 4 | * ~~ [Area for TCB. 


3556 (DE4) ENQDEQPL ENQ/DEQ parameter list. 
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WORKAREA DSECT VS2.03.808 


WORKAREA serves all CVOL Processor catalog CSECTs as intermediate 
storage, communications area, and buffers. BLDLAREA is a portion of 
WORKAREA that serves the resident BLDL routines. For a locate function, 
BLDLAREA is separate from WORKAREA. 


Many of the fields in the WORKAREA overlay other fields, and sections of an 
area can have more than one label. Figure 5-1 shows where these overlays occur, 
by label. The listing for any module shows more labels and more detail; only the 
most significant are shown here. 


When function is non-locate, one area (GETMAIN) 
is used for all purposes. 


When function is locate, two areas are used. Space 
for BLDL comes from GETMAIN. 


WORKAREA 


WORKAREA 
| The caller’s area* is used for WORKAREA 


| RETDATA 
The caller’s area* is redefined as RETDATA 
to pass data back to the caller. 


*The ‘caller’s area’ in this context refers not to 
the caller of SVC 26 but to the module 
(IGGOCLCA or IGGOCLCB) which calls 
|IGGOCLCC. The'caller’s area’ is actually 
~~ within the WORKCLCA data area described 
To previously. 


BLDLAREA 


(Input) 
BLDLAREA 


(Output) 


Figure 5-1. Data Area Hierarchy 
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Bytes and Name and 
Alignment (Content Field Description and Meaning 


0 (0) 4 BLDLIST  |List parameter for BLDL or, when 
SAVETTR3 |appropriate, the name of the last valid index 
level. 
4 (4) [| NAME Name or alias in the entry that is being 
ALIASNAM operated on. 
5 (5) GENNO Generation number portion of an absolute 
GDG name. 


12 (C) 3 TTR Relative track address in the current entry, in 
the form TTR. 
15 (F) acl TYPE Type of entry; also the binary number of 


halfwords following in the remainder of the 
entry. TYPE is interpreted as: 


Either an index pointer entry (IPE) or an 
index link entry (ILE). The name field of an 
ILE always contains 
X*FFFFFFFFFFFFFFFF ; the name field of 
an IPE never does. 


x‘ol’ Volume control block pointer entry (VCBPE). 
X*02’ Generation index pointer entry (GIPE). 


X*03° Index control entry (ICE) or old CVOL 
pointer entry (CVPE). An ICE always appears 
as the first entry of the index; a CVPE always 
appears in the volume index. 


x‘°04’ Alias entry (AE). 


x*0S’ Volume index control entry (VICE) or new 
CVOL pointer entry (CVPE). The VICE 
always appears as the first entry of the first 
block of the catalog; a CVPE always appears 
later in the volume index. 


X‘07’ Data set pointer entry (DSPE with one volume 
identification). 

xX*OD’ DSPE with two volumes. 

x* 13° DSPE with three volumes. 

x*19° DSPE with four volumes. 


DSPE with five volumes. 


X‘1F 
16 (10) TRUE The true name related to the alias in offset 4. 


16 (10) 2 VOLCNT Number of volumes idéntified in DATA when 
the current entry is a data set pointer entry 
(DSPE). 

16 (10) 62 DATA Volume identifications for DSPE. 


88 (58) ERRCATSV |Error code generated for non-locate function. 
89 (59) ERRLOCSV |Error code generated for locate function. 


90 (SA) wl | Switches declaring requested function. 
The index control entry (ICE) must be read. 


SYSCTLG has no more room during CATBX 
or BLD*X function. 


The DCB/DEB was freed by SVC 28 
processing. 


CATBX request. 
UCATDX request. 


Locate request. 


RECAT request. 


ao a Pn ae S 


(continued) 
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(cont.) 
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Bytes and Name and 
Alignment Content Field Description and Meaning 
el 


Switches used to specify flow of control. 
RPS device. 

Alias entry has been found. 

Sequence error. 


Last entry found was a CVOL pointer entry 
(CVPE). 


Generation index pointer entry (GIPE) has 
been found. 


[Alias entry has been built. 


Save area for temporarily storing the contents 
lof general purpose registers. 


The key or count of the next block beyond the 
one read. 


Index control entry. Only bytes 8 through 15 
are saved here. 


Volume index control entry. Only bytes 11 
through 18 are saved here. 


Switches to invoke functions of IGGOCLCS. 
Absolute GDG name found. 

Free index blocks. 

Read a block for updating. 


Process EMPTY option of generation data 
group (GDG). 


Write the last block of aGDG chain when the 
GDG is full and a new one is being added. 


Build volume control blocks (VCBs). 
Free VCBs. 
Write a block. 


91 (5B) FLAG2 
Sikes 
Ln. 
Jf 
af: 
ee 
92(5C) | 28 SAVEAREA 
120 (78) g  NEXTKEY 
NEXTCNT 
128 (80) 10 ICE 
136 (88) 9 VICE 
148 (94) | FLAG3 
eee 
he 
aie 
ie 
Aiee 
ee 
a 
149 (95) 1] 


Switches to specify the flow of control in 
IGGOCLC6. 


New entry has been inserted into block now in 
the work area. Updating is in process. 


The updated block has been written into 
SYSCTLG. Updating is complete. 


The block following the block pointed to by 
field WRITETTR is free. 


The first write has occurred. 


The block following the block pointed to by 
field LINKTTR is free. 


150 (96) NAMLEN _|{Length of the full name given by caller minus 
Ii, 


152 (98) 


156 (9C) 


161 (Al) 


(continued) 


NAMDELMP | Address of last delimiter in given name. 


NAMLSTP_|Pointer to last displacement of given name in 
the name table. 


Flag bits 
CVOL has extended security. 


Switches to specify flow of control in 
IGGOCLC7: 


Low-level index is involved. 

VFHOLE needs to be updated. 

LSTBLK needs to be updated. 
FSTBLK needs to be updated. 


Data Areas 
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(cont.) 


Bytes and Name and 
Offset Alignment Content Field Description and Meaning 

162 (A2) eal MODMAPI |Trace of modules that have been entered. The 
appropriate bit is set to | as each module is 
entered. There is no bit for subroutine 
IGGOCLCO, because it is always entered 
before any other. 

| re IGGOCLC] 
i |e IGGOCLC2 
ies IGGOCLC3 
boll.ce IGGOCLC4 
ee ee IGGOCLC5 
Pe IGGOCLC6 
| - Dares sol IGGOCLCT © 

164 (A4) 4 EPBLDL Address of the entry point of the supervisor 
routine BLDL, IECPBLDL (copied from field 
CVTPBLDL of the CVT). 

=f — ee 

168 (A&) 4 BLDLISTP | Address of the list to be completed by BLDL 
(address of field BLDLIST, offset 0 of this 

= i _ _DSECT). 

172 (AC) 4 DCBADDR |Address of the data control block (DCB) for 

_ | ee __|the control volume. 

176 (BO) 4 DEBADDR [Address of the data extent block (DEB) for 

_ ; te [the control volume. 

180 (B4) + FOUNDENT |Address of an entry in an input/output buffer. 

184 (B&) 4 EPTORLTV |Address of the entry point IECPRLTYV, a 
Supervisor routine that converts absolute track 
addresses to relative track addresses (copies 

7 a from field CVTPRLTV of the CVT). 
| ; 

I88 (BC) 4 EPTOABSL | Address of the entry point IECPCNVT, a 
supervisor routine that converts relative track 
addresses to absolute track addresses (copied 

oo [from field: CVTPCNVT of the CVT). 
192 (CO) 7 | SVRBEXTP | Address of the extension to the SVRB. 
196 (C4) ADDING _ | Address of new entry, meaningful only when 
| | bit 0 of FLAG4 is X'L’. 
200 (C8) 4 __| SVBALREG | Branch and link register save area. 
— 204 (CC) 12 = ig Reserved 
216 (D8) |2 LNKENTRY |General form of index link entry (ILE). The 
first eight bytes contain 
| —_ __|X*FFFFFFFFFFFFFFFF’. 
224 (EO) 4 LINKTTR _ |Last four bytes of LNKENTRY; contains the 
; | ___| TTR for this ILE. _ 

228 (E4) 4 WRITETTR | Save area for relative address of block to be 

eee written. a 

232 (E8) 4 ICETTR Relative track address of block that contains 

| |an index control entry (ICE). 

236 (EC) 4 SAVETTR_ [Save area for any relative track address. 

240 (FO) 4 READTTR  |Save area for relative address of block to be 

| read. 

244 (F4) 4 CWAP Pointer to catalog controller work area. 

248 (F&) Bs _ NAMLF Number of levels of the name that were found. 

250 (FA) i er NAMLG Number of levels in given name. 

252 (FC) 4 DEVTYPE_|Device-type portion of an identification. 

256 (100) | THETA Angular displacement value (theta) for 

7 rotational positioning support (RPS). 

257 (101) A INDEXLEN |Length of all levels given except the last. Used 
with SCRATCH macro instruction. 

(continued) 
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Bytes and | Name and | 
Offset Alignment /Content Field Description and Meaning 


258 (102) ll ERRSV2H _ Exceptional return code from subroutine 
1GC0002H. 

259 (103) oat Serial-number portion of a volume 
identification. 

16 (10) 44 DSNAME ss|Data set name to be scratched when 
processing GDG data sets. 

60 (3C) 12 SCRPARM |Parameter list for SCRATCH macro 
instruction. 

72 (48) 4 SCRVOLS_ |Volume list for SCRATCH macro instruction. 

32 (20) 44 NAMTABLE |Name table containing the length and 
displacement of each component of the given 
name. 

76 (4C) 1 NAMDELIM | Last delimiter in the given name, either ‘6’ or 
‘ (’. 

128 (80) 8 RELNUMBR | Work area for Convert-to-Binary (CVB) 
instruction used with relative GDG 
processing. 

136 (88) 8 PKDNUMBR | Work area for PACK instruction used with 
relative GDG processing. 

0 (0) 256 RETDATA |Volume list returned to caller. 


252 (FC) REDSCBT |Relative track address of the DSCB in the 
VTOC for a single-volume data set, as 
returned to the caller. 


259 (103) hey RETCVOL |Serial number for the control volume 
containing the returned volume list. 


265 (109) VICESAVE |Save area for volume index control entry 
(VICE) information. 


268 (10C) 4 BALREGS _|Save area for register used in BAL instruction. 

272 (110) | 400 BLDLAREA |Work area for use by BLDL routine; for a 
locate function, WORKAREA is in two parts, 
and BLDLAREA is the second part. 

272 (110) 48 SVAREA2H | Register save area for subroutine IGCOO02H. 

320 (140) 16 ESTAEPRM |ESTAE exit routine parameter list. 

336 (150) 24 ESTAESVA |ESTAE information area for ESTAE error 
exit cleanup. 

360 (168) | 16 ESTAELST _ESTAE record parameter list. 

632 (278) 120 BLDLCNT _|Parameters for BLDL routine. 

752 (2FO0) 4 BASESAVE |Save area for the register that would otherwise 
be destroyed by BLDL. 

640 (280) 44 RESALIAS_ | Work area used when resolving an alias name. 

376 (178) 256 INPUT Input buffer for channel program. 

376 (178) 256 TRTABLE |Transilate table used with TR instruction to 
analyze the given name. 

632 (278) 8 SIDE1 Search-ID-Equal CCW. 

640 (280) 8 TIC1 Transfer-In-Channel CCW. 


ce) | emNcew: CCW that is changed to do the required 
‘input/output function. 
| 656290) | 8 | RC 
| 664(298) | 8 
| e72q@zao) | 8 | TIC2__—(| Transfer-In-Channel CCW. 
| 68028) | 8 «| = NOP__—[NOPCCW. ———“‘(C;™CCCd 
| 6720284) | -40—~—*«é‘“‘XLW#*;*~‘~<ST Input/output block for channel programs. 
732(@2Dc) | 8 __| __RKD__|Read-Key-Data CCW. 
740(2E4) | 8 | RD __|Read-Data CCW. 


748(2EC) | 8 ~~ || =~ WKD__| Write-Key-Data CCW. 
756 (2F4) OUTPUT  |Output buffer for channel programs. 
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CAMLSTD DSECT 


CAMLSTD describes the parameter list provided by the caller of CVOL Catalog 
Management. It maps the result of the CAMLST macro instruction. 


Bytes and Name and 
Alignment (Content Field Description and Meaning 


0(0) CAMOPTN|1 | First option byte. 
Catalog is not on SYSRES. 
or ee CAT or CATBX request. 
soe ll Sess RECAT request. 
aioe Dare UNCAT or UNCATDX request. 
1(1) - Second option byte. 
2(2) ne 
VS CAMLST. 
VSAM parameter list. 


33) | 1 | CAMGEN 


4(4) 4 CAMPTRI_ |Address of the name field in caller's area. For 
locate-by-block, the name field contains a 

8(8) CAMCVOLP |Address of CVOL Catalog volume serial 
number (a 6-byte field). 


relative track address instead of a name. 
12(C) 4 CAMPTR3 _|Address of caller’s third parameter. Meaning 
Other Not used 


depends on the function: 

16(10) 4 CAMDSCBP | Address of three-byte field containing the 
relative track address (TTR) for the Format 1 
DSCB for the data set named through 
CAMPTRI. 


Do not allocate a catalog. 
BLDX or CATBX request. 
BLDG request. 
BLDA request. 
LNKX request. 
DLTX or UCATDX request. 
DSCB TTR has been specified. 


DLTA request. 
Third option byte. 


DRPX request. 
Scratch GDG data sets. 


Empty generation index when maximum 
generation count is reached. 


Locate Caller’s 265-byte work area 
BLDA 8-byte name field 


LNKX 10-byte volume 
identification 

CAT, CATBX 

or RECAT Volume list 
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Diagnostic Aids 


VS2.03.808 


This chapter provides several aids that can be useful when diagnosing difficulties 
with the CVOL Processor. Before you use the following diagnostic aids, be sure 
that the CVOL Processor received control as a result of your SVC 26 
instruction. That is, make sure that the CVOL Catalog you are referencing is 

properly defined in the VSAM Master Catalog. Also make sure that the data set 

you are referencing is defined as an alias of the CVOL Catalog if you are not 

explicitly specifying the CVOL volume serial in your SVC 26 request. You can use 

the Access Method Services LISTCAT command to list the VSAM Master Catalog. 
Refer to the IBM publication OS/VS2 Access Method Services for more information 

on the LISTCAT command. Refer to the IBM publication, OS/VS2 MVS CVOL 
Processor, for more information on how to set up the CVOL Processor. 


CSECT IGGOCLCA is written in PL/S-2, a high-level proprietary system language. 
Listings on microfiche consist of the PL/S-2 source code, a cross-reference 

and attribute table, and the assembly code. See the IBM publication Guide to 
PL/S I for a more detailed explanation of PL/S and its listings. 


CSECTs IGGOCLCB, IGGOCLCC, IGGOCLCD, and IGGOCLCE are written in 
Assembler language. Of the various symbolic programming languages, Assembler 
language is the closest to machine language in form and content. Listings on 
microfiche consist of the Assembler source code, a cross-reference and attribute 
table, and the assembly code. For more information on Assembler language, see 
the IBM publications OS/VS-DOS/VS-VM/370 Assembler Language and OS/VS- 

VM/370 Assembler Programmer’s Guide. 


Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 


Figure 6-1 can help you determine which subroutine of CSECT IGGOCLCA is 
involved in any given situation. The figure consists of several charts. Each chart 
shows the path through CSECT IGGOCLCA for the function(s) noted with that 
chart. 


Only subroutine GENLOC calls CSECT IGGOCLCB. Therefore, the GENLOC 
chart shows the path through IGGOCLCEB as well as the path through 
IGGOCLCA. 


Note: The entry point for the CVOL Processor, CSECT IGGOCLCA, the 
subroutines IGGOCL1A and SRCHPCCB, and the external subroutine IEFAB4F5 
are common to all of the functions represented in these charts. 
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OS CAMLST Format Request 


IGGOCLCC 


GETUSERK 
GETSVCK 


Figure 6-1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
(Chart 1 of 7) 
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Figure 6.1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
(Chart 2 of 7) 
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SUPERLOCATE with GDG Base Supplied 
SLGDG 


IGGOCLCC 


LOCNAME 

IGGOCLCC 
LOCTTR 

IGGOCLCC 
LOCTTR 


IGGOCLCC 


IGGOCLCC 


GETUSERK 


GETSVCK 


GETUSERK 
GETSVCK 


LOCTTR 


IGGOCLCC 


Figure 6.1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
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SUPERLOCATE GDG Base Only 


LOCNAME 
IGGOCLCC 


GETSVCK 


GETUSERK 


GETSVCK 


IGGOCLCC 


IGGOCLCC 


IGGOCLCC 


GETUSERK 
GETSVCK 


Figure 6.1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
(Chart 4 of 7) 
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SUPERLOCATE - Normal SUPERLOCATE 


IGGOCLCC 


IGGOCLCC 


LOCTTR 


IGGOCLCC 


Figure 6.1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
(Chart 5 of 7) 
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SUPERLOCATE with GENERIC LOCATE Specified 


GETUSERK 
GETSVCK 


IGGOCLCC 


POINTER 
IGGOCLCC 


Figure 6.1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
(Chart 6 of 7) 
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VSAM LOCATE OR VSAM LOCATE-LISTCAT (NOT-GET NEXT) 
VLOC 


GETUSERK 


GETSVCK 


LOCNAME 


IGGOCLCC 


One or more of the following: 


GETUSERK 


GETSVCK 


IGGOCLCC 


GETUSERK 


GETSVCK 


GETUSERK 


GETSVCK 


DSCBTTR 


GETUSERK 


GETSVCK 


GETUSERK 


GETSVCK 


Figure 6.1. Subroutine Selection Charts for CSECTs IGGOCLCA and IGGOCLCB 
(Chart 7 of 7) Diagnostic Aids 6-7 


Subroutine Selection Charts for CSECTs IGGOCLCC, IGGOCLCD, and IGGOCLCE 


Figure 6-2 can help you determine which subroutines of the CVOL Catalog 
Management CSECTs are involved in any given function. The figure consists of 
several charts that are modifications of Figure 3-7 of this publication. Each chart 
shows the path through the CVOL Catalog Management subroutines for the 
functions noted on that chart. The specific path is shown by an arrow. Always 
enter subroutine IGGOCLCO, which is the entry point for CSECT IGGOCLCC 
(upper left), then move down and to the right. 


LOCATE Simple or Qualified Name LOCATE Relative GDG Name 
with an Alias 


IGGOCLCO 


IGGOCLCO 
| iGGocLc2 


DLTX, BLDX, BLDG, LOCATE Relative 
DRPX, DLTA GDG Name 


IGGOCLC6 


EE GOCLC7 


LOCATE Qualified Name 
with an Alias 


Figure 6-2. Subroutine Selection Charts for CVOL Catalog Management (Chart 1 of 3) 
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CATBX 


IGGOCLC6 
x GOCLC7 


CAT, UNCAT, RECATLG, UCATDX 


IGGOCLCO 


LNKX and BLDA 


Cpe 


IGGOCLC3 


Figure 6.2. Subroutine Selection Charts for CVOL Catalog Management (Chart 2 of 3) 
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Catalog functions with VCB processing required, 
GDG Empty option required, or blocks to delete 
(UCATDX) 


IGGOCLC3 
od GOCLC7 


Figure 6.2. Subroutine Selection Charts for CVOL Catalog Management (Chart 3 of 3) 


J 
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Reading Dumps VS2.03.808 


All of the CVOL Processor CSECTs use the ESTAE macro for error analysis. 
For more information on the ESTAE macro, refer to the IBM publication 
OS/VS2 System Programming Library: Supervisor for more information on the 
ESTAE macro. If you get an 11A Dump when running the CVOL Processor, the 
ESTAE macro determined that the error was caused by bad information in the 
parameter list passed by the SVC 26. 


Have the following items available before requesting additional assistance: 
e Source or input listing for the use of the CVOL Processor. 


e Main storage dump produced by using a //SYSABEND DD statement. 
¢ Dump of CVOL Catalog data set. 


Two kinds of dumps can be used while diagnosing trouble with the CVOL 
Processor: main storage dumps and CVOL Catalog data set dumps. This section 
points out significant diagnostic clues to look for. It does not explain the full 
meaning of dumps; for that information, see OS/VS2 System Programming 
Library: Debugging Handbook. 


Main Storage Dump 


Each CSECT of the CVOL Processor has its own identifier. The identifier is 
eight characters long, IGGOCLCA for example, and appears in the first few 
bytes after the entry point to the CSECT. 


If an ABEND dump was produced because of an error in one of the 
CVOL Catalog Management CSECTs, then look at the content of the general 
registers at the time of the ABEND. The most significant registers are: 


Register 4 _—_Base register for all CVOL Catalog Management subroutines, 
except IECPBLDL, which uses register 15 as a base register. 


Register 6 Pointer to WORKAREA. The field MODMAPI1 shows which 
subroutines have been entered; compare this to the expected path 
for the requested function. The section ‘‘Subroutine Selection 
Charts” for CVOL Catalog Management in Figure 6-2 shows the 
path for each function. 


Register 8 Pointer to CAMLST passed to IGGOCLCC. This CAMLST may 
be either the original CAMLST (built by the issuer of the SVC 26 
instruction), or a CAMLST built by the Interface Mappers. 


Register Usage for the CVOL Processor 
None of the CVOL Processor CSECTs use standard register linkage. Refer to 
the following lists for register used by each CSECT. 

Register Usage for CSECT IGGOCLCA 


Registers: 


10 Second base register for CSECT 
11 + First base register for CSECT 
12 Base register for WORKCLCA structure 
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Register Usage for CSECT IGGOCLCB 


Registers: 


11 Base register for CSECT 
12 Base register for WORKCLCA structure 


Register Usage for CSECTs IGGOCLCC, IGGOCLCD, and IGGOCLCE 


CVOL Catalog Dump 


Registers: 


4 Base register for the CSECT 

6 Base register for WORKAREA DSECT 
8 Base register for CAMLSTD DSECT 
12 Linkage register for BAL instructions 
14 Linkage register for BAL instructions 


There are several ways to dump a data set; this discussion assumes that 
AMASPZAP is used. AMASPZAP is a service-aid program that operates under 
the operating system. AMASPZAP is described in OS/VS2 System 
Programming Library: Service Aids. 


To dump the catalog with AMASPZAP, use the following JCL, where the 
//SYSLIB DD card points to the CVOL to be dumped: 


//DUMPSTEP EXEC PGM=AMASPZAP 
//SYSPRINT DD SYSOUT=A 
JASYSLIB DD DSNAME=SYSCTLG,UNIT=xXxxx, 
// VOL=SER=xXxxXxXxx,DISP=OLD, 
a DCB=( KEYLEN=8 ) 
J//SYSIN DD * 
ABSDUMP ALL 
/* 
This JCL is used to dump the entire catalog. You can dump a portion of the 
catalog by specifying beginning and ending track addresses. 


The DCB parameter KEYLEN in the //SYSLIB DD statement formats the key as 
well as the data for each block. The key appears as the first two words of the first 
line of each block. The data for the block begins in the third word. 
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Example of a CVOL Catalog Dump 


Figure 6-3 shows an actual dump of the catalog. Entries in the volume index are 
outlined, and other blocks of the catalog are identified. 


KEY CNT VICE IPE ILE CVPE 
DSPE **CCHHR- \p001000601__ RECORD _LENGTH- 0108 a 
OOO [‘FFFFFFFF  FFFFFFFF | '0074p000 * 00000000 0010000 01050000 11000000 
ry rare 40404040 00000007 00013000 ¥ 2001C4E4  D4E5D6D3 O000GC9DS % ESDSE3D6 | Alias 
000040 , D9IEB0000 00053000 2001FOFO  FOFOFOF1 D7C1£8D9  D6D3D340 00000200 | D7D940ee-4 
000060 * 40404040 00000204 DIC1E8D9 D6D3D340 FFFFFFFF  FFFFFFFF 00000000 | 00000000 
oo0cKHO | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
0000A0 | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
0000cO | V0000000 = 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
QO00EO | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
000100 | 00000000 00000000 CNT ee 
KEY .2*CCHHR- 0001000602 RECORD LENGTHA 0108 First block of 
~ 00000~LDICIEZED 40404080 [2dr epo00 0090099 ooo 10009 7 2030000" 92010000 J C109C8 "index ‘PAYROLL’ 
000020 | C9ESCS40 0000001F 00053000 2001C4E4 D4ESD6D3 00003000 2001C4E4 SD3F1 
000040 | 00003000 2001C4E4 D4ESD3F2 000030C0 2008ESC3 C2C3D2F1 000030CO 2008E5C3 
voooeo | ¢2C302F2 v000D3C1 ¢2DED940 40400000 001FO00S 30002001 C4E4D4E5 D6D30000 
000080 | 30002001 C4E4D4E5 b3F10000 30002001 C4E4D4E5 D3F20000 30C02008 = ESC: 3.23 
OOOOAO | D2F10000 30C02008 = ESC 3C2C3.—s« D2F 20000 D3C9E2E3 40404040 0000001F 00053000 
o000cO | 2001C4E4 D4ESD6D3  00U03000 =. 200 1C4E4 D4E5D3F1 00003000 2001C4E4  D4ESD3F2 
QOOOEO | 000030CO 2008ESC3 = C2C3D2F1 000030C0 2008E5C3  C2C3D2F2. - OOOOFFFF- Ss FF FFF FFF 
000100 | FFFFOO000 03000000 
KEY S2CCHHR- OUU1NUC603 RECORD LENGTH- 0108 
OOU00O—~= FFFFFFFF FFFFFFFF | 00COD4D6 DS5E3C8D3 E8400000 001F0005 30002001 4E4D4ES Second block of 
000020 [ D6D30000 30002001 C4E4D4E5 D3F10000 30002001 C4E4D4ES D3F20000 wee index ‘PAYROLL’ 
000040 ] E5C3C2C3. = D2F10000 §=30C02008_ ~— ESC. 3.23 D2F20000 D9CSD7D6 DIE34040  ))00001F 
000060 | 00053000 2001C4E4  D4ESD6D3 00003000 2001C4E4 D4ESD3F1 00003000 2001C4E4 
000080 | D4ESD3F2 000030CO 2008E5C3 C2C3D2F1 000030CO 2008E5C3 C2C3D2F2 0000E2C1 
QOOOAO | D3C1D9E8 40400000 04010000  E3c9D4CS C3C1D9C4 00000502 00050004 FFFFFFFF 
0000CO | FFFFFFFF 00000600 00000000 00000000 00000000 00000000 00000000 00000000 
O0O000EO | 000C0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
000100 | 00000000 00000000 


KEY **CCHHR- 0001000604 


KEY 


FFFFFFFF 


RECORD LENGT 


FFFFFFFF 


200 1C4E4 


DSE5SD6D3 


00003000 


2001C4E4 


D4ESD3F1 


000020 [ 00003000 2001C4E4  D4ESD3F2 000030C0 2008ESC3 C2C3D2F1 000030C0 2008E5C3 
000040 | C2C3D2F2 000030CO 2008E5C3 = C2 302F3 000030C0 2008E5C3 C2C3D2F4 00000000 
000060 | 00000000 00000000 00000000 00000000 00000000 00000000 00000000 _ 00999009 Volume control 


000080 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 block 
OO00A0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

0000c0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

OOOOEO 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

000100 00000000 00000000 


**CCHHR- 0001000605 


FFFFFFFF 


RECORD LENGTH- 0108 


FFFFFFFF 


00880000 


00000000 


00010000 


05030000 


05000000 


C70FOFOF 


000020 OBESFOFO 00000007 00013000 200 1C4E4 D4E5D6D3 0000C70F OFOFOCES FOFOOO0O00 
000040 00070001 30002001 C4SE4D4ES D6D30000 C70FOFOF ODESFOFO 00000007 00013000 
000060 2001C4E4 D4ESD6ED3 0000C70F OFOFOEES FOFOQO000 00070001 30002001 C4E4DGES 
000080 D6éD30000 FFFFFFFF FFFFFFFF 00000000 00000000 00000000 00000000 00000000 
OOOOA0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0000000 Generation index 
0000C0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
OOOO0EO 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 


000100 00000000 00000000 
**CCHHR- 0001000606 RECORD LENGTH- 0108 
Y 090000. FFFFFFFF FFFFFFFF OOA2E 3D6 E3C1D3IE2 40400000 001FO0005 30002001 C4ESD4E5 
KE 000020 D6éD30000 000200 C4ESD4ES D3F 10000 30002001 C4ESD4ES D3IF20000 30C02008 
000040 ESC 3C2C3 D2F 10000 30C02008 ESC 3C 2C3 D2F20000 E8D9E 3D6 C4C1E3C5 0000001F 
000060 00053000 2001C4E4 D4ESD6D3 00003000 200 1C4E4 D4ESDIFI 0000 3000 2001C4E4 
000080 D4ESDIF2 000030C0 2008E5C3 C2C3D2F1 0000 30c0 2008E5C 3 C2C3D2F2 OOOOFFFF 
OOO0A0 FFFFFFFF FFFFOOOO 00000000 00000000 00000000 00000000 00000000 : 
0000c0 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 Third block of ’ 
OOOOEO 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 index "PAYROLL 
000100 00000000 00000000 
**CCHHR- 0001000607 RECORD LENGTH- 0108 
00000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
KEY sosore | ooOSSEsS 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
000040 00000000 00000000 00000000 00000000 00000000 00000000 00000000 0000000 
000060 00000000 00000000 00000000 00000000 00000000 00000000 00000000 a a block of 
ATIC RE 10090C¢ 20000000 00000009 00000026 ooo0rs>S 000000 00000900 2°N0000/1 


Figure 6-3. Example of a CVOL Catalog Dump 


SYSCTLG 
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The data portion of each block begins with a 16-bit binary number that tells how 
many bytes of the block are used (including the two bytes of this number). The 
catalog entries begin immediately thereafter. These entries are described in detail 
in the chapter ‘‘Data Areas.” 


The first entry of the first block is always the volume index control entry (VICE). 
The type of each entry can be determined from the byte at offset 11 of the entry; 
the type codes are described under the field TYPE in the WORKAREA DSECT 
found in Chapter 5 of this publication. 


Environment Record 


6-14 


Some error conditions cause an environment record to be written, whenever 
possible, to the last block of the CVOL Catalog. The environment record is 
written when a non-locate function is requested, and the exceptional return code is 
8 or 28. Here’s how you can dump the catalog and examine this record to see what 
happened: 


1. Reproduce the failure, but this time reserve the data set CVOL Catalog for your 
exclusive use, so that no other task can destroy the environment record before 
you can dump it. Do this by adding or modifying your JCL statements to 
include a DD statement for CVOL Catalog with DISP=OLD. 


2. Add a step to your job to dump CVOL Catalog. Follow the instructions under 
“CVOL Catalog Dump.”’ 


3. Look at the VICE, which begins at offset two of the first physical block of the 
catalog. (Remember to allow for the key.) Field VCLSTBLK (offset 12 bytes 
in the VICE) contains the TTR for the last block in CVOL Catalog. This block 
contains the environment record. 


4. Compute the absolute track address by using the cylinder-head numbers 
supplied for the first block and the TTR. TT is the relative track from the first 
block; R is the record number for that track. 


5. The fields of the environment record are described in ‘“‘Environment Record 
(EREC DSECT),”’ in the ‘‘Data Areas”’ chapter of this publication. 


The description for each field relates this information to other data areas. 


The field ERMODMATP contains seven bits that show which subroutines have 
been entered. IGGOCLCO is always entered; there are no bit switches for this 
subroutine. 


As an example, if ERMODMAP equals X‘76’, then modules IGGOCLCO, 
IGGOCLC2, IGGOCLC3, IGGOCLC4, IGGOCLC6, and IGGOCLC7 were 
entered during the request that caused the environment record to be written. This 
is the sequence of subroutines that normally occurs with a request for CATBX. 


Note: The environment record is not written for any error associated with a 
“catalog-full’’ condition. 
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Glossary 


This glossary contains definitions of words and 
acronyms that are used in this publication. Other data 
processing definitions can be found in the Data 
Processing Glossary. 


alias: An alternative name for a data set. Ina CVOL Catalog, 
only the high-level name of a fully qualified data set name may 
have an alias. 


cataloged data set: In a CVOL Catalog, a data set that ts 
represented in an index or hierarchy of indexes that provides 
the means for locating the data set. 


communication vector table (CVT): An operating system control 
block that provides the address of information in the nucleus 
to non-resident routines. 


control volume (CVOL): An OS/VS Catalog that contains one 
or more of the indexes. 


CVOL catalog: The collection of all data set indexes maintained 
by CVOL Catalog Management. 


data control block (DCB): An operating system control block 
that describes the current use of the data set. 


data extent block (DEB): A control block that describes the 
physical attributes of the data set. 


data set: The major unit of data storage and retrieval in the 
Operating system. 


data set control block (DSCB): A label for a data set on a direct 
storage volume. 


data set name: An identifier that unambiguously names a data 
sel. 


data set pointer entry (DSPE): A CVOL Catalog entry that 
identifies the volume on which a named data set resides. 


dequeue: To remove a request for a resource from a list of 
requests. 


DEQ: An Assembler language macro instruction used to 
remove control of one or more serially reusable resources from 
the active task. It can also be used to determine whether 
control of the resource is currently assigned to or requested for 
the active task. 


enqueue: To build a list of requests for a named resource. 


ENQ: An Assembler language macro instruction that requests 
the control program to assign control of one or more serially 
reusable resources to the active task. It is also used to 
determine the status of resource, that is, whether it is 
immediately available or in use, and whether control has been 
previously requested for the active task in another ENQ macro 
instruction. 


entry: A logical record of a catalog. 


environment record: A 256-byte record that is written when 
CVOL Catalog Management discovers an error. This record, 
which contains significant data that is present at the time of 
the error, is written to the last block of data set SYSCTLG for 
later analysis. 


ESTAE: A Supervisor macro instruction used to extend the 
recovery capability of the STAE macro. ESTAE provides more. 
levels of recovery than the STAE macro. 


EXCP: An Assembler language macro instruction that requests 
the initiation of the I/O operations of a channel program. 


FREEMAIN: An Assembler language macro instruction that 
releases one area of main storage that had previously been 
allocated to the job step as a result of a GETMAIN macro 
instruction. 


generation: One member of a generation data group. 


generation data group (GDG): A collection of historically related 
data sets. 


generation index: An index of the CVOL Catalog that identifies 
the generations of a generation data group. 


generation index pointer entry (GIPE): A CVOL Catalog entry 
that identifies a generation index. 


GETMAIN: An Assembler language macro instruction that is 
used to allocate an area of main storage for use by the job step 
task. 


high-level name: The first component of a qualified name. This 
name is found in a volume index of the CVOL Catalog. 


index: A table in the CVOL Catalog structure that is used to 
locate data sets. 


index control entry (ICE): The first entry of each index of the 
CVOL Catalog. This entry contains all control information 
about the index. 


index link entry (ILE): The last entry of each block of the 
CVOL Catalog, used to link blocks of one index together in a 
chain. 


index pointer entry (IPE); A CVOL Catalog entry that attaches 
a lower-level index to the index in which it is found. 


level: A conceptual relationship between indexes of the CVOL 
Catalog. The index corresponding to the simple name of a 

data set is said to be the lowest level: the first component of a 
qualifier name is said to correspond to the highest-level index. 


LINK: An Assembler language macro instruction that causes 
control to be passed to a specified entry point. The linkage 
relationship established is.the same as that created by a BAL 
instruction. 


locate: Pertaining to functions that do not change the status of 
a Catalog: that is, read-only operations are performed. 
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MODESET: A Supervisor macro instruction used to change the 
system status by altering the PSW key or the mode indicator. 


must-complete: An indication to the operating system that the 
event must be performed without interruption or waiting. 


non-locate: Pertaining to functions that change the status of a 
catalog: that ts. write Operations are performed. 


partitioned data set directory: The portion of a partitioned data 
set that provides a means of locating any of the members of 
the data set. 


qualified name: A data set name consisting of a string of names 
separated by periods: for example. ““TREE.FRUIT.APPLE., © is 
a qualified name. 


qualifier: Hach component name in a qualified name other than 
the rightmost name. For example, **> TREE” and ““FRUIT™ are 
qualifiers in “TREE.FRUIT.APPLE. 


relative track address (TTR): A direct-access device address. 
expressed as a displacement in a data set. This address has the 
form TTR. where TT represents two hexadecimal digits 
specifving the track relative to the beginning of the data set. 
and R ts one hexadecimal digit specifying the record on that 
rack. 


resource: Anv facilitv of the computing system or operating 
system required by a job or task. including main storage. 
input/output devices. the central processing unit, data sets. and 
control processing systems. 


RETURN: An Assembler language macro instruction that 1s 
used to return contrél to the calling CSECT and to signal 
normal termination of the returning CSECT. 


ripple: Moving data from one block of a chain to the next, due 
to modification of data in a preceding block. 


SAVE: An Assembler language macro instruction that causes 
the contents of the specified registers to be stored in the save 
area at the address contained in register 13. 


SCRATCH: An Assembler language macro instruction that 
points to the CAMLST macro instruction. SCRATCH. the first 
operand of CAMLST. specifies that a data set be deleted. 


simple name: The rightmost component of a qualified name. 
For example, “APPLE” is the simple name in 
“TREE.FRUIT.APPLE. The simple name corresponds to the 
lowest index level in the CVOL Catalog for the data set name. 
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supervisor request block (SVRB): An operating system control 
block containing program status information and general 
register contents. 


SYSCTLG: The data set name of the CVOL Catalog. 


system residence volume: The volume on which the nucleus of 
the operating system is located. 


task control block (TCB): An operating system control block 
that contains information and pointers associated with the task 
In progress. 


true name: In a CVOL Catalog, the high-level qualifier to 
which an alias ts related. 


uncatalog: To remove the catalog entry of a data set from a 
catalog. 


volume control block (VCB): A block of the catalog that 
identifies as many as 20 volumes containing one data set. 


volume control block pointer entry (VCBPE): A CVOL Catalog 
entry that identifies a VCB for a named data set. 


volume index: The highest level of index in the CVOL Catalog 
structure. Entries in the volume index point to all lower 
indexes and simple names. 


volume index control entry (VICE): The first entry in the volume 
index. The VICE describes the volume index and controls 
space allocation in SYSCTLG. 


volume table of contents (VTOC): A table associated with a 
direct access volume that describes each data set on that 
volume and identifies all available space on the volume. 


WAIT: An Assembler language macro instruction that informs 
the control program that the issuing program cannot continue 
until a specific event, represented by an event control block, 
has occurred. 


XCTL: An Assembler language macro instruction that causes 
control to be passed to a specified entry point. 
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name Read Operation .. te Oe. each oe detec Ga 2-8 
qualified Sel a Te Bast em ES GE, gh READ routine in IGGOCLC7 .. . . . . . . . 2-9,3-40.3-41 
simple . % 7-2 Reading Dumps... n° ge BS es Gee es ee ae OD | 
NAME data field . 5-6 READTTR data field... 2... SR 
name and content in data areas 5-| RECATLG function . . Be Gg! a A Bead, Jaya Belid 
NAMLEN data field 5-7 RECATALOG Return Codes,OS ........... 34 
NAMLEF data field 5-8 REDSCBT data field . 2. 2 2) 59 
NAMLG data held 5-8 Register Usage 
NAMLSTP data field . . 5] IGCO002F (VS2.03.808) ----.--+-.-....+. 3d 
NAMTABLE data field . 5 IGGOCLCA. ....... ee te Ag ke Se, . 3-11, 6-11 
NEXTCNT data field . 5-7 IGGOCLCA (VS2. 03.808). ......... .3-L1.1, 6-11 a 
NEXTKEY data field . . i i Ee a Bee, ay 2ST IGGOCKCB. .. . pet Spot hake € Sak Ls G12 
NEXTLWVL routine in IGGOCLC2 4. fe Whe ako ty Bh Se, te a RR IGGOCLCB (VS2. 03. 808) 5 ia! ge ae tee es ce a S611 
non-locate, definition . BAUS ie det weet ee at 7-2 IGGOCLCC. . be bo a ew we a BeLR,-6-12 
non-locate functions .......... a re ie “i &,2-9 IGGOCLCD. eae ; . . 3-18, 6-12 
GATB XR. (4 ae a ee ee a 133: 14,3-32,3-36 IGGOCLCF. . . 3-18, 6-12 
method of operation... . . 2... 1 ee. 227,2-8 REGI3SAV data field ee ee » §-2 
RECATLG ............. . +. 3-13,3-14,3-34 relating function to subroutines . 2... .....2.2.2.~«29 
UCATDX ........... . . 3-13,3-14,3-34,3-36 relative 
NOP data wield. 22-1, em Gb Ge St oh ete a BEG, S089 converting to absolute track addresses . . . ... . . 3-16 
generation data group processing ... . . . . 3-26,3-27 
re) track address (TTR), definition... .. . 7-2 
OR TAL ACSUBROULING- 6-0. @ co Soe ow A ew & a BO Relative GDG and Alias, IGGOCLCI] .... 3-11,3- 26,3-27 
Off-page connector . 8 RELNUM data field 5-3 
Glicet incdata areas’ « RELNUMBR data field . . 5-9 
OLDKEY data field Repackaged Catalog Management . 3-12 
On-page connector Requests to IGGOCLCA 3-7 
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Requirements of the CVOL Processor 
requirements . . 

RESALIAS data field . 

RESCAN subroutine 


Resource Access Control Facility (V (vs2. 03. 808) (see RACF) . 


resource, definition . 

Resource Enqueuing 

IGGOCLCA.... 
IGGOCLCB . 
IGGOCLCC . 
IGGOCLCD 
IGGOCLCE . 
IGGOCLCF 

restrictions . : : 

RETCVOL data field 

RETDATA data field . 

RETURN macro instruction . 
definition . 

ripple 
definition . 
method of Speralten : 

RKD data field: 

routine 
BLDENTRY in IGGOCLC4 
BLVCBRTN in IGGOCLCS 
CALLBLDL 

in IGGOCLCI 

in IGGOCLC2 ' 
EMPTYRTN in IGGOCLCS 
FRBLKRTN in IGGOCLCS 
FRNDXRTN in IGGOCLCS5 
FRVCBRTN in IGGOCLCS5 
GET 

in [IGGOCLC4 

in IGGOCLC6 
INCR 

in IGGOCLC4 

in IGGOCLCS 
10 

in (GC0O002H 

in [GGOCLF2 


in IGGOCLC3 
in LGGOCLC6 


in IGGOCLC4 

in IGGOCLC7 
1O3 

in IGGOCLCS 
KEYICE in IGGOCLC3. 
MOVELVL in IGGOCLC3 
NEXTLVL tn IGGOCLC2 
PUT in IGGOCLC6 . . . 
SCRATCH in [IGGOCLC4 
SETUP 

in IGGOCLC4 - 

in IGGOCLCS 
TOABSL 

in IGGOCLC3 

in IGGOCLCS5 

in IGGOCLC6 

in IGGOCLC7 

relation to IECPCNVT. 
TOABSL2 
TORLTV 

in IGGOCLC2 

in IGGOCLC3 

in IGGOCLC5 

in IGGOCLC6 

in IGGOCLC7 

relation to IECPRLTV_ 
UCATDX tn IGGOCLC2. . 
WRBLKRTN in IGGOCLCS5 
WRLSTRTN in IGGOCLC5 
WRTSRCH in IGGOCLC3 . 

RPSD DSECT (VS2.03.808)... . 


Ss 
SAVEAREA data field 


VS2.03.808 


SAVE macro instruction utes wine Sh Ge os SP . 3-11 

GeliiliOM xd. Erbe Ques Ee Ge oe Re ea ee Ba ek Be 
SAVE] data field. 2... ......2022022~220202. 042653 
SAVER] data field... ......202202+2022424 5- 


SAVER3 data field . 
SAVER4 data field . 
SAVER6 data field . 
SAVER 10 data field 
SAVERII data field 
SAVERI2 data field 
SAVETTR data field 
SAVETTR3 data field 
SBASE data field . 
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lw OO GO Ww WwW Ww WwW WN NY 


SCRATCH 

definition... Ot, oe AE ga ee antes’ “ad ce WA, er 

macro instruction di er siae he tas A Mes ee oat pe at. Be et ee 

WIG GOCL CA}. s- e222 2 Be a Ys ot Bek a a P&S 
SCRPARM data field . 2... 2... SD 
SCRVOLS data field ............2.2.+2.2.2. 5-9 
Search, IECPBLDL. . . » . . 3-14,3-15,3-30,3-3 | 
Second Load of Update, IGGOCLC6 ; 3-15,3-38,3-39 
service Subroutines. Ge. dn. san 8S* ty ake de tne BOSD 
Services Used by CSECTs: 

IG GOEGEECEC. s x a) Bo a gk Sb & fe Sal. SF yo od . Jo ATO 

KiGOUCLGD -2 5:0 4 ws ee ee Ee Goi © 2 Se ol 

IG@GOGIECE. +2 .e a! a Big eens Ee ee ee be SEG Sel 

IGGOCLCF .. i... . 3-16 
Setup Operation (CVOL Extalap Management) wc te tas accede “Des 
SETUP routine 

int IGOOCEC4... 2 & @ ea: Bc 2 aS & BR & & aos 43298 

im IGGOCLCS , 20s. hw 4 kw ee a we we a 3587 
Shalzy 22h. % 4 Pcs. fe 2a aes “ae aa ae WS, Be cet BE oat eas tg a Se BID 
SIDE! data Fret OSS ots Ce ben Se RE tat! ae WAI S. e, O  ee Se 
simple name 

GOTT IVT fh 6 ss we, an Nett ne owt  e k a a a oe Se EZ 

CRANE vel 2 ve Ga ee at ae pine ee. oe. ee Ge es 
SKE daiticdield! < S-- ae e- ee fei we Oe Bee he we eg SD 
supervisor call (SVC) 

Phy 4.3 Yee Se 2 aw & SESE 
supervisor request block (SVRB) BM te Ai edt wh GP as Die Ge ee 

GeLNUUON 6° s. 6 ee eB oe em ee eS aoe, hark Fe 
SLGDG subroutine . 2. 2 2 ee 
SLGDGB subroutine . 2... 2... ee 
SLGDGBL subroutine . 2... 2... ee 
SLNAME subroutine . 2... 2... ee eH? 
SLVOLST subroutine . 2... 2. en 4-2 
SRCHPCCB subroutine . 2... a 9 94-2 
SUPERLOC subroutine . de ee a 3 3-20, 3. 21.4-2 
SVAREA2H data field 2... 0... .0.0.0024827, .. 39 
SVBALREG data field . 2... .....2.2.2.2.2.2.. 5-8 
SVC (see supervisor call) 
SVRB Gee supervisor request block) 
SVRBEXTP data field So ep Beha uk ae ws GS ye od sere ct pe EO. 
SVRBSAV data field 2... 2... 5D 
SYSCTLG . a ae ae oe |-| 

definition . . 7-2 

entry formats (VS2. 03. 808) as Jie Wt, fees oe e's 5-1 - 5-1.6 


SYSCTLG Formatter, IGGOCLF2 

SYSCTLG Open/Extend, 1GCO0002H . 

System Macros Used CSECTs: 
IGGOCLCA . ; 


3-16,3-44,3-45 
3-16,3-42,3-43 


3 

IGiGUGEECB ts 2 4. 4%. 4a ie ea Je ee &» & ae 
POiGrOC TCG. 30nd ee ae. a ee Ee ee OS ee 
IGGOCLCD 3 
ISGGOCICE = & £6 eS a pe SL Se Bed 
IGGOCLCE: © a te. ao Fa BE ho ee OR cae wt Sw ee ae SE 3- 
system requircments ae I 
system residence, catalog .. . ob Se 2 Be a el SS 
system residence volume, definition fis vg ee a, eae ae! Oe 
SYS1.LPALIB l 


’ 
ee) 


NN] NaAAANY- 


T 
task control block (TCB) Bir Bt he SS ae esl a aes eee 

definition... Bc ge ak’ AG re AS ae Si Be wk oe ak ate te ch 
TCBPTTR data field 5-2 
THETA data field eas a f 5-8 
Third Load of Update and Error Handling 

IGGOCLC7 . ae 3-16,3-40, 3-41 
TIC) cdata field's @. % & a.204:6 e-toc “ee Boe ee ee 5D 


Index 8-5 


VS2.03.808 


WAG? Gale Tels a3. se Sead Bak ob Py te ce ave ie ieee boat | EO 
TOABSL routine 

in IGGOCLG3......20¢«2.¢02@~¢02@~SF ee. 3-83 

IM MOIGOG GS ue ne Sb ee de my ks Bas Se ae se a 957 

in: IGRCIDCL CG: Ss a Soe Re eee Se Se ae «39 

in IGGOCLC7 . ee Ae, hes ae Moa ih. Si De Bee 

relation to IECPCNVT . b Gis Wael em Seok: Bae SB ee Se 2 OA 
TORLTYV routine 

In IGGOCL G2) oe ek ka oe oe od Be oO 

inIGGOCLO3. . 2. 2... 3-33 

Wi IGG ECS 3 ee ee mk OR OS Se ee ee we 

iMMGOUCIIE Ais. eed ee ee Bn ES ee ee BED 

in IGGOCLC7 . ge: We dR AGL A Si ded 1g BS eg at Cid Sl 

relation to LF CPRLTV Bt eG te eto le By Wea hs oh BELG 
tracing through 

CVOL Catalog Management subroutines. . 2. 2. .) 6-8 

Interface Mappers subroutines 2... . OD 
track address conversion... . eee ee 8 
transient area 

definiion 2... Hobs GO tans ou, Ae Pee Megs ee 

definition (deleted by VS2. 03. 808) 
TRIABLE data field . . . . bo oe ak wl ae ede Cede S29 
TRUE data field tes ea te iat idee Ge, Ge cay ake etn Oe age A why sa ae, BED 
true name. definition 2. 2 2. 2. 
TTR data field . . 5-6 
TYPE data field 5-6 
U 
UCATD®X function . . Stoner wr Gh ac Se hoe Ae ah HO 
UCATDX routine in IGGOCLC2° b der-te end an. % Bice B28 
UNCATALOG Return Codes. OS . . 2... 2 1... 3-4 
uncatalog, definition 2... 2 2 2 ee 7 
unit control block (UCB) 2... 2... 3-24 
updating index control entry 

method of operation... eS th GA oe ce, ED 
Updating Initialization and Entry Building. 

IGGOCLC3 . . . 2. 3+16,3-32.3-33 
Using the CVOL ey Management Routines. 2... 3-9 
V 


VCB (see volume control block) 

VCBPE (ee volume control block pointer entry) 

VCBROUT subroutine... 4-4 
VICE (VS2.03.808) (see Galuiie nde control SAicy ‘(VICE)) 


VICE data field 5-7 
VICESAVE data ficld. bs Boog Be He he da BC ae Bs ce, ae. HOE 
Visual Table of Contents 2.0. 0.0.0.2... 2... . . . 2-3 
VLOC subroutine 2. 2... we 88 -2013-2 14-2 
VOLOENT data Tiel 3: oe we Gok we re Ge ee ce  & 6 
VOLSN data field 2. 2. 2 2 . 5-9 
volume control block 


definition . de te ce ae Ea HS ew 
definition (VS2. 03. 808) . Gh Jucigatiiines Ga ks Ga ku cdy gc gee Oe Lee 
method of operation a ok ee le toy Zee 
volume control block pon entry (VCBPE). Se ae bs hh @ ee Sez 
definition .- : a Batons Bec ale Nee gs ee al, wl a te See 
definition (VS2. 03. 808) . ee ee ee ee 
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method of operation . 2 
volume index. definition ge ahi> Sy. he Ale aioe Gt oda Sse « 
volume index control entry (VICE) . ee ae ee ee ee 

definition . . Baits Coes eo be, Neu, v 

definition (VS2. 03. 808) . : 1 
volume table of contents (VTOC). definition 7 
VSAM SUPERLOCATE Return Codes When n Accessing 

CVOL Catalogs . 2... 2... . 3-4 
VSRCI5 data field 5-2 
VTOC (see volume table of Bonlenish. 


WwW 
WAIT macro instruction .........2.2... 2. =. 3+17 

definition... deny Be fe eR MG seo ay i See Bi ts ee 
WKBLANK data fila: yh te Real cats ene a a SC aa Bs Ge TOES 
WKCAMLST data field. 2... 2... 2... 52 
WKCATANM data field . 2... 2.2.2.2... 2... 52 
WKCATNM data field 2... 2. 2 2. eee 
WKCVOLP data field 2. 2... 2... 8 
WKCVOLYVS data field . 2... 2. Ww ee 52 
WKD data field 2. 2...) ee ee 8D 
WKDSCBP data field. 2... 2... 2 
WKDSCBT data field. 2... 2 0. 2 ee. 53 
WKDSN data field . 2 2...) ee 83 
WKNXTTR data field 2. 2... ee 88 
WKOPTNS data field. 2. 2. 2 2. 2. we S82 
WKPTRI data field 2... 2... 82 
WKPTR3 data field . 2... 2... ee 5 
WKVOLNUM data field 2... 2... 5B 
WKVOLS data field 2. 2... ...2.2.2.2.2.2.2.2. 2. . 5-3 
WKVOLST data field... S ep th Se Ue Bact He ae 
WORKAREA DSECT ak area 

fOPIAL pe -2s 3 ok ee Ee oe te ee ea a a BO 

initializing oo... ae ate oe A eho . . 3-1.3- 
work areas, matali oui 3-1 3-2 
WORKCLCA data area 

POI: a. SAS a oat eee Ets we ae od pe cae BL DZ 

initializing oo. ey Re Pad ae at tt BE me ee ee oe ceo TE lASel 
WRAPUP vamrauine A 4g: fg wee ee we ee 2G ARS 
WRBLKRTN routine in IGGOCLCS gh aes ees “Ke te Be gt Quedeoal 
write operation... be ah te ee Bk Be RD 
WRITE routine in IGGOCLC? . S. abs weit int aft. idk ee. 1 ees a et 
WRITETTR data field 2. 2... 2... 2. S88 
wriling environment record... Ma se bei wa & 2poal 2. GETS 
WRLSTRTN routine in IGGOCLCS Be Bi A? egy t ob? Sq Seg, ROSES 
WRTSRCH routine in IGGOCLC3 ..... . 2... 3-33 
WTO macro (VS2.03.808) 

use: Of (VS2.03.808) -.© @ @ 2a we Sms Be ew ee es S-17 
x 
MCLs Ge vac aE Sek aah cep ake Sa ee el a Se - TD 
XCTL macro instruction . 2...) 8-17 

definition... eS gy Ye ale-nad on As Feo ee da eG, a ae Oe 
XSAVAREA data field ss upearte ct, oh: a ee Hh eh ok, ce ee oe ts GE. POEL 
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